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PREFACE 


The MVS/Extended Architecture System Logic Library is intended 
for people who debug or modify the MVS control program. 


describes the logic of most MVS control program functions that 
are performed after master scheduler initialization completes. 
For detailed information about the MVS control program prior to 
this point, refer to MVS/Extended Architecture System 
Initialization Logic. For general information about the MVS 
control program and the relationships among the components that 
make up the MVS control program, refer to the MVS/Extended 
Architecture Overview. To obtain the names of publications that 
describe some of the components not in the System Logic Library, 
refer to the section Corequisite Reading in the Master Preface 


in MVS/Extended Architecture System Logic Library: Master Table 
of Contents and Index. 


HOW THE LIBRARY IS ORGANIZED 


SET OF BOOKS 


ORGANIZATION OF THE 


The System Logic Library consists of a set of books. Two of the 
books provide information that 1s relevant to the entire set of 
books: 


1. The MVS/Extended Architecture System Logic Library: Master 
Table of Contents and Index contains the master preface, the 


master table of contents, and the master index for the other 
books in the set. 


2. The MVS/Extended Architecture System Logic Library: Module 
Descriptions contains module descriptions for all of the 
modules in the components documented in the System Logic 
Library and an index. 


Each of the other books (referred to as component books) in the 
set contains its own table of contents and index, and describes 
the logic of one of the components in the MVS control program. 


COMPONENTS 


Most component books contain information about one component in 
the MVS control program. However, some component books (such as 
system Logic Library: Initiator/Terminator) contain more than 
one component if the components are closely related, frequently 
referenced at the same time, and not so large that they require 
a book of their own. 


A three or four character mnemonic 1s associated with each 
component book and is used in all diagram and page numbers in 
that book. For example, the mnemonic ASM is associated with the 
book MVS/7Extended Architecture System Logic Library: Auxiliary 
Storage Management. All diagrams in this book are identified as 
Diagram ASM-n, and all pages as ASM-n, where n represents the 
specific diagram or page number. Whenever possible, the 
existing component acronym is used as the mnemonic for the 
component book. The Table of Book Titles in the Master Preface 
in MVS/Extended Architecture System Logic Library: Master Table 
of Contents and Index lists the book titles, the components 
included in each book (if a book contains more than one 
component), the mnemonics for the books, and the order number 
for each book. 
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HOW TO USE THE LIBRARY 


FINDING INFORMATION 


FINDING INFORMATION 


To help you use this library efficiently, the following topics 
cover 


e How to find information using book titles and the master 
index 

e What types of information are provided for each component 

e How to obtain further information about other books in the 


System Logic Library 


USING THE BOOK TITLES 


As you become familiar with the book titles, MVS component names 

and mnemonics, and the book contents, you will be able to use 
the System Logic Library as you would an encyclopedia and go 

directly to the book that you need. We recommend that you group 
the books in alphabetical order for easy reference, or, if you 

rie ee with MVS, that you to group the books by related 
unctions. 


The Table of Book Titles in the Master Preface in MVS/Extended 
Architecture System Logic Library: Master Table of Contents and 
Index contains a list of book titles and mnemonics. It provides 
a quick reference to all the books, and their corresponding 


components, in the System Logic Library. 


USING THE MASTER INDEX 


If you are not sure which book contains the information you are 
looking for, you can locate the book and the page on which the 
information appears by using the master index in System Logic 
Library: Master Table of Contents and Index. For the component 
books, the page number in an index entry consists of the 
mnemonic for the component and the page number; for System Logic 
Library: Module Descriptions, the page number consists of the 
mnemonic "MOD" and the page number. 


For example: 


ASM-12 refers to MVS/Extended Architecture System Logic 
Library: Auxiliary Storage Management, page ASM-l2. 


MOD-245 refers to MVS/Extended Architecture System Logic 
Library: Module Descriptions, page MOD-245. 


INFORMATION PROVIDED FOR MOST COMPONENTS 


1vV 


MVS/XA SLL: 


The following information is provided for most of the components 
described in the System Logic Library. 


l. An introduction that summarizes the component's function 


2. Control block overview figures that show significant fields 
and the chaining structure of the component's control blocks 


3. Process flow figures that show control flow between the 
component's object modules 


G. Module information that describes the functional 
pl oeee ey ree of a program. This information can be in the 
form of: 


° Method-of-Operation diagrams and extended descriptions. 


° Automatically-generated prose. The automated module 
information is generated from the module prologue and 
the code itself. It consists of three parts: module 
el a module operation summary, and diagnostic 
aids. 
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5. Module descriptions that describe the operation of the 
modules (the mocure descriptions ae contained in System 


¢ Logic Librar odu r 
Some component books also include diagnostic techniques 
information following the Introduction. 


FURTHER INFORMATION 


For more information about the >yste em Logis Library, including 


the order numbers of the books in the 2yst em_Logic Library, see 


the date ial? Preface in Ms Exte ended Arch atecture system Logic 
ibra aster Ta S an nde 
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SUMMARY OF AMENDMENTS 


LY28-1760-0 


Summary of Amendments 
for LY28-1760-0 
for MVS/System Product Version 2 Release 2.0 


This publication is new for MVS System Product Version 2 Release 
2.0 It contains information that was reorganized from the 
System Resource Manager (SRM) section in MVS/XA System Logic 


Library Volume 12 ., LY28-1250-3, which applies to MVS/XA System 
Product Version 2 Release 1.7. 


This publication contains changes to support MVS/System Product 
Version 2 Release 2.0. The changes include: 


e Module Description for the following new module: 
IRARMCBS 


e The following changed modules: 


TRARMEVT TRARMFIP 
IRARMFPG TRARMSRV 
TRARMWLM TRARMWLS 


e Minor technical and editorial changes throughout the 
publication. 
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The system resources manager (SRM) is a component of the base 
control program CBCP). The SRM is responsible for the efficient 
management of system resources and has two principal objectives: 


e To distribute the use of the system's processor, I/0,;, and 
storage resources among individual users (address spaces) in 
a way that satisfies the installation's response time, 
turnaround time, and work priority requirements. (The 
installation specifies these goals in SYS1.PARMLIB member 
IEAIPSxx. ) 


e To optimize the use of resources by system users in terms of 
system throughput. 


The SRM achieves its objectives primarily through swapping 
decisions and dispatching priorities, using a number of 
algorithms to compute values on which to base its judgements. 
Swapping is the process of moving address spaces into and out of 
real storage. Dispatching is the process of initiating the 
execution of an address space. By making decisions that maximize 
the number of address spaces in real storage and assigning 
Priorities that maximize the rate of their execution, the SRM 
contributes a great deal to the ability of the system to do more 
work. 


The process operates in the following way. When an address space 
is swapped out its entire working set Cactive user pages) moves 
to auxiliary storage or extended storage. The SRM uses the real 
page frames released by the swap for paging activity by other 
address spaces or for swapping in a sSwapped-out address space. 
When swapped in, an address space competes for system resources 
with all other swapped-in address spaces. 


Note: Extended storage and expanded storage are terms that have 
the same meaning. This book uses the term extended storage. 


To control this contention, the SRM assigns priorities to 
address spaces. These priorities may be fixed or governed by the 
mean-time-to-wait algorithm. An address space controlled by the 
mean-time-to-wait algorithm executes with a priority based on 
relationships between its use of processor and I/0 resources. 

To provide more flexibility, an address space may be time-sliced 
between two dispatching priorities. The IPS defines the duration 
of a time slice. 


Page replacement and device allocation algorithms in the SRM 
further support effective use of time and system resources. In 
the page replacement process, the SRM finds which real frames 
show less activity than other frames and release the less active 
frames for different work. In the device allocation process, the 
SRM selects which devices can be used to store tape and DASD 
data sets having non-specific volume requests. 


The SRM obtains control as a result of the execution of a 
SYSEVENT macro instruction. The SYSEVENT macro instruction, 
Signalling the occurrence of a user of system-related event, 
serves as an extended routing function based on the SYSEVENT 
code generated from the specified operand. Each SYSEVENT code 
represents a logically distinct interface to the SRM, with its 
own circumstances, its own input and output conventions, and its 
own resultant SRM actions. 


The SYSEVENT processing function receives control from the 
interface function to perform processing related to the 
SYSEVENT. Depending on the SYSEVENT type, either IRARMINT or 
IRARMFIP obtains control. IRARMINT is a generalized routine that 
passes control to IRARMEVT, which contains a separate processing 
routine for each SYSEVENT routed through IRARMINT. IRARMEVT 


Cc) Copyright IBM Corp. 1987 Introduction SRM-3 


SRM_ FUNCTIONS 


SRM-4G@ MVS/XA SLL: 


"Restricted Materials of IBM" 
Licensed Materials — Property of IBM 


routes a device allocation SYSEVENT to IRARMEV2, an expansion 
module of IRARMEVT. IRARMFIP contains separate entry points for 
SYSEVENTs whose execution time is critical 


The SRM maintains the information needed for its functions 
Primarily in the resource manager control table €RMCT), which is 
contained in IRARMCNS and located by a pointer in the CVT 
CCVTOPCTP). The SRM keeps track of user Caddress space) 
information in user control blocks (COUCBs), user extension 
blocks COUXBs), and user swap blocks COUSBs). 


SRM control is the dispatcher of the SRM, residing in the module 
IRARMCTL. Along with various other SRM routines, particularly 
IRARMSWP, it schedules and processes requests for actions and 
algorithms related to swap analysis and swap processing. 


A set of resource-use algorithms manages the use of system-wide 
resources. Designed to improve overall system resource use, 
these algorithms calculate values that promote effective storage 
management, I/0 management, and processor management. The 
resource monitor supplies these algorithms with necessary system 
information. 


The workload manager of the SRM, a collection of subroutines 
that monitor the rate at which individual address spaces use 
system resources, supplies the swapping recommendations that SRM 
control requests. The workload manager also collects data for 
resource measurement facility (CRMF) workload activity reporting. 


The SRM consists of a number of modules whose names generally 
begin with the prefix IRARM. Each module, however, does not 
directly correspond to a unique SRM function. Rather, separate 
entry points within the modules identify the various functions 
that make up the SRM component. 


The major functions of the SRM and the modules containing the 
entry points that perform them are: 


e Swap analysis: IRARMSWP uses an algorithm to select which 
users from which domains to swap in or out. The swap 
decisions are based upon domain targets and swap 
recommendation values that the workload manager and resource 
use algorithms supply. 


e Multiprogramming level (MPL) target adjustment: IRARMRMR 
uses algorithms to monitor system use and raise or lower 
domain MPLs accordingly. 


e Storage management: IRARMSTM and IRARMST2 manage storage 
using the following algorithms: 


Unreferenced interval count CUIC) update 
Page replacement 

Auxiliary storage shortage prevention 
Pageable storage shortage prevention 

SWA storage shortage prevention 

Storage isolation 

Storage load balancing 


e I/O load balancing: If the installation requests I/0 load 
balancing, IRARMIOM uses an algorithm to assign I/0 swap 
recommendations to address spaces based upon their use of 
logical paths that are out of balance (underused or 
overused). 


M CPU load balancing: If the installation requests CPU load 
balancing, IRARMCPM uses algorithms to measure processor 
utilization and compute processor swap recommendations for 
address spaces. The CPU swap recommendations complement the 
I/0 swap recommendations that I70 load balancing generates. 
IRARMCPM contains other algorithms to control changing 
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priorities (chapping) of address spaces that are in the 
mean-time-to-wait group or that have changed performance 
group periods. IRARMCPM also contains functions to activate 
and deactivate the time-slice algorithm. 


e Time-slice: IRARMFIP invokes ASCBCHAP, which changes the 
Priority of an address space on a dispatching queue. 


e Workload management: IRARMWLM uses a timed algorithm to 
periodically compute new workload manager recommendation 
values for address spaces. IRARMWLM also contains routines 
for start, stop, suspend, and resume transaction processing 
and period change processing. IRARMWLS contains the user 
ready swap-in scheduling routine. 


e Workload reporting: IRARMWLS, IRARMWAR, and IRARMFIP perform 
the workload reporting functions. IRARMFIP contains the 
subsystem transaction reporting routines. IRARMWLS contains 
a timed algorithm that manages the transaction reporting 
queues. IRARMWAR contains routines that update the workload 
activity measurement table CWAMT) for both MVS (TSO, started 
task, and batch) transactions and subsystem transactions. 


Most system components use the SYSEVENT macro instruction to 
communicate with the SRM. SYSEVENTs fall into three classes: 


e Address space SYSEVENTs: notify the SRM of a change in 
status for a particular address space 


e System status SYSEVENTs: notify the SRM of a change in 
system status 


e SRM service SYSEVENTsS: request a particular SRM support 
function 


The SYSEVENT macro instruction generates either a branch or SVC 
entry (SVC 95) into the SRM. By enqueueing a time queue element 
CTQE), the SRM can also invoke itself on a timed basis. When the 
period of time has passed, the TIME SYSEVENT issued by the timer 
SLIH drives the SRM. The SRM interface ensures that the SRM 
executes in 3l-bit addressing mode and that the caller's 
addressing mode is restored on exit. 


Entries can be any of three SRM interface modules: IRARMINT, 
IRARMGLU, or IRARMFIP. IRARMGLU contains 24-bit entry points 
that pass control to IRARMGLU and IRARMFIP in 3l-bit addressing 
mode. IRARMINT, a generalized routine, passes control to 
IRARMEVT, which contains a separate processing routine for each 
SYSEVENT routed through IRARMINT. For the device allocation 
SYSEVENT CDEVALLOC), the expansion module of IRARMEVT CIRARMEV2) 
obtains control. IRARMFIP, the fast interface processor, 
contains entry points for SYSEVENTs that require rapid 
processing. 


Branch entry callers must be in supervisor state or key 0-7, and 
associated data areas must be page-fixed. Disabled page faults 
that occur when user data areas are referenced cause the 
SYSEVENT issuer to be abnormally terminated Cabend code X 
'15F'). Branch entry callers must also pass, in register 13, 
the address of a 72-byte save area, which can be stored by using 
the caller's key. The SYSEVENT issuer is responsible for 
serializing the use of this area (by means of disablement, 
global lock, or local lock). 


SYSEVENT 26 requires no authorization. For other SYSEVENTs, 
authorization required for SVC entry depends on the SYSEVENT. 
Programs that issue SYSEVENTs 29 and 2A either must have APF 
authorization or must be assigned the nonswappable program 
property (CPPTNSWP='1') in the program properties table. All 
other SYSEVENTsS require that the calling program be 
APF-authorized or in supervisor state or protection keys 0-7; 
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also, its associated data areas must be page-fixed. Unauthorized 
use of the SVC entry, like disabled page faults that occur while 
referencing user data areas, causes the SYSEVENT issuer to be 
abnormally terminated Cabend code X'15F"). 


The SRM interface passes control to the SYSEVENT processor 
related to the particular SYSEVENT. Depending upon the SYSEVENT, 
the SRM might then perform further processing not necessarily 
related to the invoking SYSEVENT. Thus, many SYSEVENTs serve 
both as status change notifiers, or service requestors, and as 
occasions for performing a wide range of SRM processing. 


Providing a common point of invocation and simplified access, 
the SRM interface also processes requests from internal SRM 
routines that service system components. These include such 
services aS cross memory post, obtaining SQA storage, and 
issuing a write-to-operator (WTO) message. The service interface 
routines, each with its own entry point, reside in the module 
IRARMSRV. Figure 1 lists SRM entry points and identifies the 
module that contains them. This figure also includes the 
addressing CAMODE) and the residency (RMODE) attributes for each 
module. More detailed descriptions of each entry point can be 
found preceding the method-of-operation diagrams that illustrate 
each module. 
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RARMEVT 
RARMFIP 
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IEAVNP10 
RARMINT 
RARMIOM 
RARMIPS 
RARMOPT 
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SYSEVENT PROCESSOR 


LY28-1760-0 


The SYSEVENT processor function CIRARMEVT or IRARMEV2) receives 
control from the interface function to perform processing 
related to the SYSEVENT. In a multiprocessing environment, the 
system may not be able to perform some of these routines 
immediately because of concurrent SRM processing on another 
processor. Execution of the requested routines is then deferred 
until a subsequent invocation of the SRM. SYSEVENTs with 
critical execution time requirements use a special fast 
interface, IRARMFIP, rather than the SYSEVENT processor, 
IRARMEVT. SYSEVENT 1C Cdevice allocation) receives control from 
IRARMEVT but the code that processes the request resides in the 
module IRARMEV2. 


SYSEVENT processors often invoke other SRM functions. Some of 
these functions are executed as subroutines of the SYSEVENT 
processor. Other functions, called actions and algorithms, are 
treated differently. An action is a user-related function, 
executed if the SRM lock is held, deferred if the lock is not 
held. An algorithm is a function executed on behalf of the 
system instead of the user; its execution is always deferred. 
SRM control CIRARMCTL) executes deferred actions, algorithms, 
and timed (periodically invoked) algorithms. 


Depending upon what higher level locks are held by the SYSEVENT 
issuer, SYSEVENT processors might or might not obtain the SRM 
lock. SYSEVENTs that do not hold the SRM lock return directly to 
the SRM interface for return to the issuer. SYSEVENT processors 
that hold the SRM lock generally exit by branching to the SRM 
control module, IRARMCTL. SRM control exits by returning to the 
interface module, IRARMINT, whether SRM control is entered via 
IRARMEVT or IRARMFIP. 


Figure 2 lists all SYSEVENTs in alphabetical order with their 
associated codes (in hexadecimal). 


Figure 2. 


ALTCPRECC21) 
AVQLOW(17) 
AVQOK(18) 
BRINGINC2C) 
CHANNEL (48) 
CMDEND(40) 
CMDSTARTC3F) 
CONFIGCH(1D) 
COPYDMDT(28) 
DDRC47 ) 
DEVALLOCC1C) 


ENQHOLD(14) 
ENQRLSEC15) 
HOLDC32) 


€c) Copyright IBM Corp. 


ICSCHKC3C) 
INITATTCOA) 
INITDETCOB) 
JOBSELCTC08) 
JOBTERM(C09) 
MEMCREAT (06) 
MEMDEL (07) 
MIGCNSTRC42) 
MIGPURGEC43) 
MIGSWAP (C44) 
NEWICSC3D) 
NEWIPS(20) 
NEWOPTC34) 
NIOWAITCO3) 
NOHOLDC33) 
OKSWAPC2A) 
QSCECMPC OD) 


SYSEVENT List 


1987 


QSCEFLC12) 
QSCESTCOC) 
REQPGDATC2 
REQSERVCC2 
REQSVDAT ¢ 
REQSWAP C2 
RESETPGC1 
RSMCNSTS( 
RSTORCMP C1 
SETDMNC25) 
SOUTSUSPC(45) 
SQALOWC19) 
SQAOKC1A) 
SWINFLC11) 
SWINSTATC10) 
SWOUTCMP COF) 
SYQSCCMP (24) 


SYQSCSTC23) 
TERMWAITCO2) 
TGETTPUT C22) 
TIMECO5) 
TIMEREXPC01) 
TRANSWAP COE) 
TRAXERPT (C35) 
TRAXFRPT (36) 
TRAXRPT C37) 
UCBCHG(C 46 ) 
USERRDYC04) 
VERIFYPGC1E) 
WKLDCHGC(41) 
WKLDCOLL(C2E) 
WKLDINITC2D) 
WKLDTERMC2F) 
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Figure 3 lists the SYSEVENTs by hexadecimal code. For each 
SYSEVENT, the figure identifies the situations that cause the 
SYSEVENT to be issued, the information passed and returned, the ) 
internal SRM routines it might invoke, the functions of the 
invoked routines, and the actions taken as a result. In 
addition, this figure indicates whether the SRM interface 
routine obtains the SRM lock and where control passes after 
SYSEVENT processing completes. All SYSEVENTS receive the 
associated codes as input information Cin byte 3 of register 0). 
Bytes 0 and 1 in register 0 pass the ASIDs listed as input. In 
the following charts, the SYSEVENT names are listed with the 
hexadecimal code followed by the decimal equivalent. 
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*duod WAI #YST4Adog (2) 


L36T 


UOT}ONposzUT 
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TIMEREXP | TOD clock Indication of 


x'01’ initialization is whether TOD 
1 complete. clock initialization 
occurred (01) or 
not (00) (register 
1, byte 3) 


TERMWAIT | Issued by TGET or |e ASID 
X‘02' TPUT when a e Input (00) or 
2 user enters termi- output (80) indi- 
nal wait. cation (register 1, 
byte 0) 


NIOWAIT** | Issued by WAIT 
X'04’ macro processing 
4 when some task in 
an address space en- 
ters long wait. 





USERRDY**! An SRB has been e ASID 
X'04’ scheduled for an 
4 address space for 
which QUIESCE is 


running, or fora 
swapped-out ad- 
dress space. 





**Note: This SYSEVENT can be invoked while executing in cross memory mode. 



















C 


Routines Invoked 


Periodic entry 
point initialization 
(IRARMWMY) 


Periodic entry 
point scheduling 
(IRARMCET) 


Control swap-out 
(IRARMCSO) 


Control swap-out 
(IRARMCSO) 


User ready 
processing 
(IRARMHIT) 
















Function of Invoked : 


Routine 





Resets the time due 
fields of the time 
driven queue accord- 
ing to the current 
time. 


See Diagram SRM-10. 


The ready user is 
placed on the OUT 
queue. 





‘When TOD clock ini- 


See Diagram SRM-12. 


See Diagram SRM-12. 












tialization occurs, this 
SYSEVENT schedules 
SRM’s time driven rou- 
tines. Subsequent sche- 
duling is done through 
SYSEVENT 05 (TIME). 


When TOD clock ini- 
tialization occurs, SRM 
starts channel 

measurements. 





















User-ready processing 
is performed through 
the action request 

routine. 


Yes 


Yes 






SRM control 
(IRARMCTL) 


SRM control 
(IRARMCTL) 


Invoker 
via 
IRARMIO1 


Invoker via 
IRARMIO1 
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WHW Sey SAS 
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SYSEVENT When Issued | information Routines Invoked Function of Invoked SRM Lock Exit To 
Held 


route 


Reorder the ASCB Yes 
Yes 

es 

Yes 











SRM control 
(IRARMCTL) 
Or invoker via 
IRARMIO1 


Invoke the rotate and 
time slice algorithms 

if they are active and 

due to execute. 



















TIME SRM timer 
X'‘05’ interval 
5 has expired. 


Rotate algorithm 
(IRARMRT1) 





dispatching queue 
for those priorities 
due to be rotated. 


Change the ASCB 
dispatching priority for 
those address spaces 
due to be time sliced up 
or down. 







(in module 
IRARME IP) 













Time slice 
algorithm 
(IRARMTS1) 








Sample channel 
measurements if they 
are active and due to 
execute. 


























Sample the current 
channel path activity 
and increment the 

channel path counts 
for active paths. 


Channel path 
status sampling 
. (IRARMCPS) 














Schedule all other 
SRM algorithms that 
are due. Set the time 
of the next invocation 
of this SYSEVENT. 












Accumulate the current 
UCB request queue 
lengths. 


UCB queue 
length sampling 
(IRARMDBS) 


Set timer routine 
(IRARMIO5) 








Start or stop channel 
measurement if TOD 
clock status changes. 







Queue a TQE to cause 
the next SRM timer 
. interrupt. 


Obtain storage for an 
OUCB and OUXEB if 

no resource shortages 
exist. 


































e ASID. 
e START(01)/ 
LOGON(0O2)/ 


SRM 
control 
(IRARMCTL) 


Indication whether 
or not memory 
creation should 


MEMCREAT | An ASID has been 
associated with a 
new address space 


Storage request 
(IRARMIO4) . 
















































and space has been MOUNT (03) proceed because of LL ~ — — ~— es el ee ee 
obtained for an indication. a resource shortage. | User control block Place user on “’in”’ User control block 
ASCB and OUSB. (register 1, (OO- proceed repositioning queue, repositioning is 

byte 0) 80—do not (IRARMRPS) performed through the 


proceed). 
(register 1, byte 0). 


action request routine. 











MEMDEL | MEMDEL e ASID Set indicator in Y SRM 
TYPE= TYPE=NOSWIN e NOSWIN OUCB to prevent control 
NOSWIN _ | 'S issued by RSM indicator swapping during (IRARMCTL) 
X‘O7' early in address (register O address space 


space termination byte 2, bit 0) 
prior to freeing 

the RSM control 

blocks. 


5 termination. 




































MEMDEL Storage associated e@ ASID Indication that OUCB and OUXB Free storage associated | OUCB and OUXB SRM 
X'07 with an ASCB is memory delete may | delete with OUCB and an delete is performed control 
7 about to be freed, proceed. (IRARMDEL) OUXB. Make sure that | indirectly, through (IRARMCTL) 
and an ASID is —00 (register 1, the rotate and time action request routine 
disassociated with byte 3). slice tables have been 





an address space. updated for this user. 
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JOBSELCT 
X‘08 
8 


JOBTERM 
X‘09’ 
9 


An address space: 
has begun using 
syslein services, On 
behalf of a new job, 
START or MOUNT 
command, ora 
TSO session, 


Address of the 
installation 
control 
specification 
parameter list 
(ICSP) 
{register 1) 











An address space e ASID 
has completed 

using the system 
resources on behalf 
of ajob, START or 
MOUNT command, 


or a TSO session 










@ Address af job- 
Nan Or user id 









None 


None 






Routines Invoked 


Control swapout 
(IRARMCSO). 


Transaction stop 
routine 
(IRARMWMO). 





Assign report and 
control performance 
groups. 
(IRARMFPG) 


Transaction stop 
routine 
(IRARMWMO) 









Function of Invoked 


Routine 





Called to swapout an 
address space if a 
second level auxiliary 
page shortage exists or 
an excess Of fixed 
frames exists. 








Updates the accumu- 
lated time and service 
for a job. Also 
indicates that the 
current transaction has 
ended or been sus- 
pended. If workload 
activity reporting is 
active, invokes 
IRARMWR4 to 
accumulate report 
information. 


Assigns the appro- 
priate control and 
report performance 
groups specified by 
the installation con- 
trol specification. 





Updates the accumu- 
lated time and service 
for a transaction. Also 
indicates that the 
current transaction has 
ended. If workload 
activity reporting is 
active, invokes 
IRARMWR4 to 
accumulate report 
information. 








Cc 












SRM Lock Exit To 
Held 
This SYSEVENT Yes SRM 
authorizes the control 
accumulation of service (IRARMCTL) 
for the job. SRM 
validates the perfor- 
mance group number 
indicated for the 
address space. If it is 
not valid, a default 
value 1s assigned. 
This SYSEVENT Yes SRM 
revokes authorization control 
for starting new (IRARMCTL) 


transactions. 
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SYSEVENT 


INITATT 
X’0A 
10 


When Issued 


Whenever an 
initiator attaches 
a task 





Information 


Address of the 
installation 
control specifi- 
cation parameter 
list (ICSP) 
(register 1) 


Returned 


None 


Routines Invoked 


Transaction 
resume processing 
(IRARMWMR) 


Assign report 
and control 
performance 
groups. 
(IRARMFPG) 


Start new 
transaction 
(TRARMWMN). 


Time slice/ 
rotate switch 
(IRARMSWT) 
Time stice/ 
rotate 
activation 
(IRARMACT) 


Change dispatching 
priority 
(JRARMIO2) 


Function of Invoked 
Routine 


Resumes a suspended 
transaction, if the 
performance group 
number for anew non- 
TSO job step is the 
same as for the 
previous step; other- 
wise starts a new 
transaction. 











Assigns the appropriate 
control and report per- 
formance groups speci- 
fied by the installation 
control specification. 


Indicate the start of 

a new transaction. If 
workload activity 
reporting is active, 
calls IRARMWRE6 to 
indicate that a 
transaction has ended. 








Adjusts the user counts 
in the time slice and 
rotate tables. 











Sets the rotating or 
time slicing status 
as active or inactive. 


Move ASCB to correct 
position on dispatcher 
queue. 





SRM Action Exit To 
SRM validates the 
performance group 
number indicated for 
the address space. If it 
is not valid, a default 
value 1s assigned. If 
the input dispatching 
priority isin the APG, 
the SRM will follow 
the IPS specification 
for this user. Time 
slice and rotate 
information is 
updated. 


SRM 
control 
IRARMCTL) 
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SYSEVENT When Issued 


INITDET | Whenever an 
initiator detaches 
a task. 












Issued during 
quiesce processing 
when the status of 
all associated tasks 
has been 

deter mined. 


QSCEST 
X‘0C’ 
12 














| : 


@ Dispatching 
e Continue with 







priority. 
(register 1, 
byte 3) 








@ ASID 












@ Long wait (QO) or terminate 
indication (08) quiesce 
(OO not im tong processing. 
wait (register 1, 
80 inlong wait).| byte 3). 
(register 1, 






byte QO) 





Routines Invoked 





Routine 











Updates the accumu- 
lated time and service 
for a transaction. Also 
indicates that the 


Transaction stop 
routine 
(IRARMWMO). 





ed. If workload 
activity reporting is 
active, invokes 
IRARMWR4 to 
accumulate report 
information. 












Frees I/O measure- 
ments control block 
(which has been 
created if the user is 
a heavy !/O user). 


Time slice/ 
rotate switch 
(IRARMSWT) 


Time slice/ 
rotate 
activation 
(IRARMACT) 


Change dispatching 
Priority 

(IRARMIO2). 
1/O load balancing 


user 1/O monitor- 
ing (IRARMILO). 


1/0 load 
balancing IMCB 
deletion 
(IRARML4). 


























in the time slice and 
rotate tables. 














Sets the rotating or 
time slicing status 
as active or inactive. 










Move ASCB to correct 
position on dispatcher 
queue. 

















An |/O measurement 
control block is 
created for heavy |/O 
users, The IMCB is 
updated with channel 
usage data from the 
Timing Control Table 
1/0 Table (TCTIOT). 
(See Diagram SRM- 
18.) If swap out is 
turned around, notify 
the TRANSWAP or 
REQSWAP issuer. 








Cross-memory 
post routine 
(IRARMIO6) 






Function of Invoked 









current transaction has 
ended or been suspend- 





Adjusts the user counts 

















IMCB deletion is 
performed through 
action request. 


















Note: After this 

SYSEVENT, no further 

qQuiesce processing is 

performed for: 

@ non-swappable users, 
and 

@® users being swapped 

because of a long 

wait, and who are 

no longer in a long 

wait status. 









SRM Lock 
Held 


Yes 


c 


Exit To 


control 
(IRARMCTL) 


control 


(IRARMCTL) 
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Transaction Quiesce 


* Issued when the 
arenes RCT has completed 
X’0D quiesce processing 
13 for an address 
space. 


*Notes: 


1. 


e Non-swappable users 


e ASID. 

e Long wait 
indicator. 
(00—nat in long 
wait 
B0—In long wait). 
(register 1, 
byte QO). 


e@ Indication 


whether the 
USERRDY 
SYSEVENT (4) 
has been received 
tor this task 

since quiesce 
start 
(Q0—received 
80—not received). 
(register 1, 

byte QO). 
Indication 
whether to 
initiate a swapout 
(00), wait ona 
QEC6B fora 
logically swapped 
address space (04), 
or begin restore 
(08). (register 1, 
byte 3). 


e Reg 1 byte 2 


contains the swap 
out reason code. 


After this SYSEVENT no further quiesce processing is performed for: 


e Users.being swapped because of along wait and who are no 


longer in a long wait status 
e Users being logically swapped 


c 


Processing 
((RARMWMO). 


CPU Load 
Balancing Profile 
Adjustment 
(IRARMCLO). 


User Control! Block 


Repositioning 


(LRARMRPS). 


2. 


Page Stealing 
(IRARMPR9) 
ASCE Priority 
Change 
(IRARMIO2) 


Function of Invoked 
Routine 


Increments the 
cumulative service 
received by a trans- 
action by the amount 
received during a real 
storage residence 
period. Also updates 
the performance group 
period indication if a 
transaction has 
completed a perfor- 
mance group period. 
Determines whether to 
continue the trans- 
action, or to stop or 
suspend it at this point 
for the reason that 
caused the swapout. If 
workload activity 
reporting is actve, 
invokes IRARMW R4 
to accumulate report 
information. 

Updates the mean time 
to wait indication for 
use by CPU load 
balancing (see 

Diagram SRM-26) and 
users in the APG. 
Changes the status of 
the address space to out- 
of-real-storage and 
Positions it on the 
correct queue 

(normally the “‘out’’ 
queue; however, will 

be the ‘‘wait.. queue 

for users entering long 
wait, or for users 
swapped because a 
resource shortage exists). 


User Control Block 
Repositioning is 
pertormed indirectly 
through action request 
routine. 


Determine swap-in 
working set size. 
Change the priority 

of a logically swapped 
address space to put 

it at the bottom of the 
dispatching queue. 





SRM Lock 


Exit To 


SRM 
Control 
(IRARMCTL) 


if a user’s think time is low enough, do not physically swap out the address space. Instead, leave 


the address space in storage, change its dispatching priority to 1, tell QUIESCE to issue a WAIT, 
and put the OUCB on the WAIT queue. This process is equivalent to a logical swap out. When the 


addréss space becomes ready again, the OUCB is moved to the IN queue, and the normal dispatching 
priority is restored. 


C 


c 
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SYSEVENT 


TRANSWAP 
X‘OE' 
14 


SWOUTCMP 
X'OF 
15 


information 


e Current ASID 

e Address of the 
ECB to be posted 
(optional) 
(register 1) 


Issued by the 
initiator for V=R 
and nonswappable 
job steps. 

Issued by the BTAM 
open routine to 
swap Out address 
spaces so that their 
LSQA and fixed 
pages can be swapped 
back into preferred 
storage rather than 
recontigurable 
storage. 


All 1/O required to 
swap Out an address 
space has completed. 


@ ASID 
@ Pointer to para- 
meter list 

(register 1) 

containing: 

— number of 
Pages swapped 
out (word 1, 
bytes 0 and 1). 

— working set 
size, in number 
of pages to be 
swapped in 
(word 1, bytes 
2 and 3). 

— indication of 
whether the ad- 
dress space is 
waiting for an 


unfinished RSM 
service (Word 2, 


byte 3, bit 7 on 
means the ad- 
dress space is 
waiting for 
service.) 


Routines Invoked 


@ Return code: 
X'00’ — The 
request was 
honored. 

X‘04’' — Another 
TRANSWAP has 
already completed. 


Control swap-out 
(IRARMCSO) 


Free OUXB 


storage 
(IRARMUXB) 


Swap analysis 
(IRARMCAP) 


User ready 
processing 
(IRARMEO4) 


Function of Invoked 
Routine 


Initiates the swap-out of 
the address space. (See 
Diagram SRM-12.) 


Free the storage associ- 
ated with an OUXB, 


Swap analysis is 
requested when a user 
is voluntarily swapped 
Out. 


See SYSEVENT 
USERRDY (04) 


Region control task 
(RCT) is posted to 
begin the swap-out. 
If an ECB was passed 
as input, the ECB is 
posted when the 
address space is next 
swapped in. 


IRARMUXB is 
perforined indirectly, 
through action request. 


Swap analysis is 
invoked through 
algorithm request 
rotuine. 


User ready processing 
is invoked if the user 
ready indicator is off, 
but an indication of an 
unfinished RSM 
service is received. 





SRM Lock 
Held 


Yes 


Cc 


Exit To 


Dispatcher for 
an SVC entry of 
SRM provided 
that a swap-out 
was begun; 
otherwise, 

SRM control 
(IRARMCTL) 


Invoker via 
IRARMIO1 
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: Function of Invoked SRM Lock 
SYSEVENT When Issued Rout i ked 
| SyseveNt reed a Korea Sati Mca Ml wie Monat 


SWINSTAT | By RSM to notify e@ ASID Stage one of IRARMSWI is Invoker via 
x10’ of swap status e Code in register 1: swap-in performed IRARMIO1 
16 00 — Swap-in is processing indirectly, through 


Starting. (IRARMSWI) action request. 
01 — Frames are 


allocated for the 
user’s working 

set pages 

02 — Address 

_ Space is swapped-in| 





























User control block re- 
positioning is perform- 
ed indirectly, through 
an action routine. The 
SRM takes one of the 
following actions de- 
pending upon the 
swap-in failure indica- 
tion code (register 1, 
byte 3): 

01 — no action. 

O2 — SRM raises the 
steal thresholds to 
obtain enough 
available frames 
for this user's 
working set pages. 
At the next invo- 
Cation of swap 
analysis, the 
swap-in is retried. 

03 — SRM puts the 
address space in 
defer status on 
the WAIT queue. 
A message is 
issued to the 
operator indicat- 
ing the storage 
requirements for 
the address space. 

04 — no action. 

Free OUXB 


User control 
block reposition- 
ing (IRARMRPS) 


Changes the status of 
the address space to 
out-of-real-storage 
and positions the 
OUCB on the correct 
queue (normally the 
out queue). 


SWINFL Swap-in processing e@ ASID None 
x'11' failed to obtain or @ Indication of 
17 initialize the LSQA swap-in fail- 
storage for an ure (register 1, 
address space. byte 3): 









control 
(IRARMCTL) 












01 — not enough 
PCBs 

02 — not enough 
frames 
available for 
the working 
set pages 

03 — the swap-in 
would cause 
a shortage 
of page- 
able frames. 

04 — there are no 
double frame . 
pairs available 
to back the 
user’s segment 
table. 



































Free storage —_ 
(IRARMI04) 
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SYSEVENT When Issued 


The RCT failed to 
complete quiesce 
processing because 
of an abnormal 
situation. 
The RCT has 
completed restore 
processing for an 
address space. 


NQHOLD* *] A user’s execution 
is delayed because 
of a request fora 
resource being held 
by another user. 

This SYSEVENT is 
aiso issued when an 
authorized program 
that issues RESERVE 
for a shared DASD 
obtains control 

of the resource, 

even if no user’s 
execution is delayed. 







C 


__tntematon _| nowt oot 








e@ Long wait 
indicator 
(00—not in tong 
wait 
80—in long wait) 

(register 1, 

byte 0) 


ASID of memory 
holding resource 

e Address of QCB 

for resource 


































User control block 
repositioning 
(IRARMRPS) 


Restore completed 
processing 
(IRARMWMR) 


User control block 


repositioning 
(IRARMRPS) 


Control swap-out 
(IRARMCSO) 


**Note: This SYSEVENT can be invoked while executing in cross memory mode. 






Function of Invoked 
Routine 


Changes the current 


status of the user 

from out-of-real- 
storage to in-real- 
storage. 

invoked so the work- 
load manager can 
initialize the fields used 
for monitoring service 
during a period of 

real storage residence. 


Changes the current 
status of the user 
from out-of-real- 
storage to in- real- 
storage. 


Requests that a swap- 
pable user still in long 
wait status, or a user 
with TRANSWAP 

or REQSWAP pending, 
will be swapped out. 











SRM Lock 
Held 
User control block Yes SRM 
repositioning is control 
performed indirectly, (IRARMCTL) 
through an action 
routine. 
Yes SRM 
control 
(IRARMCTL) 
User control block _ 
repositioning is 
performed indirectly, 
through an action 
routine. 
Users in real storage, Yes Invoker via 


IRARMIO1 


holding resources, are 
given a spurt of 
non-swappable service 
equal to the enqueue 
residence value (ERV). 
(See Diagram SRM-26.) 
Users out of storage are 
marked as holding a 
requested resource so 
that swap analysis 
(IRARMCAP) will 
initiate a swap-in. 
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SYSEVENT | tatormation Routines Invoked Function of Invoked SRM Lock Exit To 













ENOQRLSE* *|A contention or e ASID. 

potential contention | # Address of QCB 
situation has for resource 
disappeared 
because of the 
release of a resource 
by a user for whom 
an ENQHOLD 
SYSEVENT hag 
previously been 
received. 





If the user has freed all 
resources in contention, 
eliminate special treat- 
ment. 


Invoker via 
IRARMIO1 




















































































































































RSMCNSTS |Real storage has beenj @ Indication that Fixed frame thres- Recalculate thresholds IRARMMSS5 is scheduled Invoker Via 
X16’ configured into or the RSM hold calculation with current RSM for execution the next IRARMIO1 
22 out of the system counters are be- (IRARMMSS5). frame counts. time the CONTROL 
(during system initial ing initialized function receives con- 
ization or aftera (register 1, byte trol. 
CONFIG storage 3): 
command or a storage} OO — not initial- 
error). ized 
04 — initialized 
AVQLOW** | The number of e Indication of None Main storage For level 1,2,or3,in- | Because it is impor- Invoker via 
X17! available real cause. occupancy itiate page stealing. tant that the main IRARMIO1 
23 storage page frames (register 1, byte analysis (See Diagram SRM-17.) | storage occupancy 






3): 

1— Available 
queue (AVQ) 
is below limit. 

2—AVOQ is 1 
when a page 
fault occurs. 

3—AVQisO 
when a page 
fault occurs, 

4— Number of 
fixed real 
frames below 
16 megabytes 
exceeds the 
limit. 

5— Page taken 

from SQA 

reserve queue. 


has fallen below 
the available page 
queue low limit. 


For level 4, notify the 
system operator of a 
pageable storage 
shortage, inhibit the 
creation of new address 
spaces, and attempt to 
reduce the number of 
fixed frames by swap- 
ping out address spaces. 
Swap-out the address 
with significantly more 
than the average num- 
ber of fixed pages and 
identify these address 
sPaces to the system 
operator. For level 5, 
go into a 100 milli- 
second disabled spin 
loop if there is any out- 
standing paging t/O. 


analysis algorithm be 
executed as soon as 
possible, an SRB is 
scheduled after 
requesting the 
algorithm; the SRB 
issues SYSEVENTF 30 
when it is dispatched, 
which results in the 
CONTROL function 
being invoked. This 
algorithm (IRARMMS2) 
will then be executed. 


(IRARMMS2) 







































c c c 





**Note: This SYSEVENT can be invoked while executing in cross memory mode. 
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Function of Invoked 
Routine 


| - 


e Indication of None 
whether shortage 
is of severity 1 
(01) or 2 (02) 
(register 1, 
byte 3) 
Code indicating the 


level of the relieved 


shortage (register 
**Note: This SYSEVENT can be invoked while executing in cross memory mode. 


SYSEVENT 


Routines Invoked 







AVQOK** 
X‘18' 
24 


Enough real 
storage pages have 
been freed to 

alleviate a shortage 
condition. 












































SQALOW** 
X'19’ 
25 


Inform the system 
operator of the SQA 
shortage (See Diagram 
SRM-17.) 


There exists a 
critical shortage of 
SQA pages below 

16 megabytes. 


SOA shortage 
message writer 
(IRARMSQA). 




















SQAOK** 
X‘1A' 
26 


An SOA page 
shortage has been 
relieved below 
16 megabytes. 



















SQA shortage 
message writer 
(IRARMSQA). 


Inform system opera- 
tor of the fact that an 

SOA shortage has been 
relieved. (See Diagram 
SRM- 17.) 






1, byte 3): 
above fevel 1 (01) 
above level 2 (02) 


e ASID 
@ Indication of 
whether the new 
address space is 
to be privileged 


































System address space 
initialization is 
creating a new 
address space. 


EASINIT 
X‘1B' 
2/7 







Find performance 
group routine 
(IRARMFPG) 


Assigns the appropri- 
ate control and report 
performance groups as 
specified by the 
installation control 
specification. 


















(1) or not (0) 

(register 1, byte 

2, bit O). Transaction start Starts anew 
@ Code indicating routine transaction. 

dispatching (IRARMWMN) 


priority of address 
space (register 1, 
byte 3): 

— data only (00) 
— high (01) 

— tow (02) 







SRM ceases its special 
efforts to free real 
storage. 


The message writer 














algorithm is scheduled 
for execution the next 
pass through the 
CONTROL function. 
SRM does not permit 
the creation of new 
address spaces when 


an SQA shortage exists. 


Issue a message if all 


SOA shortages are 
relieved (that is, 


level 1). 





This SYSEVENT 
assigns the appropriate 
performance group, 


domain, and dispatch- 


ing priority to the new 
address space. 






If the time-of-day clock 
has been initialized, 
this SYSEVENT starts 
a transaction for the 
new address space. 














SRM Lock : 
Held Exit To 
Invoker via 
IRARMIO1 


No 






Invoker via 
IRARMIO1 









Invoker via 
IRARMIO1 

















(a) 


SRM control 
{(IRARMCTL) 
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DEVALLOC | A device allocation | @ ASID @ Pointer to same None The UCB is selected by Yes 
X‘1C’ choice must be e Pointer to a three three word list applying the following control 
28 made among two or word list as on entry selection Principles in (IRARMCTL) 
(IRARMEV2)| more candidates. (register 1) (register 1), ee eeien: 
psi A e Avoid contention (real- 
containing: with return area ; 
— address of a list containing: ecaung sane eee 
: : same user) for direct 
of candidate — address of the access. 
UCB addresses candidate list @ Avoid allocation on 
(word 1) entry that was units with premounted 
— address of a list selected volumes. 
of UCB (word 1) e Give preference to less 
addresses @ Successful (00) heavily utilized logical 
already or unsuccessful paths, assuming that 
alccated to | (08) ncicaton alent 
bomen vinta 15, known projected 
constant impact on 
— address of a utilization. 
two word @ Select the tape drive 
return area. specified in the installa- 
(word 3) tion’s |EAOPTxx parm- 


lib member. The selec- 

tion options are: 

— the next highest 
device number from 
the last allocated 
device (default) 

— the first device 
number in the 
candidate list 

— the lowest device 
number in the 
candidate list 

— random selection 
from the candidate 
list 

e For direct access 
devices, pick the one 
with the lowest average 
delay, assuming each 
previous allocation for 
this user has a known 
constant impact on 
delay. 

e@ Choose randomly, if 

more than one 
candidate remains. 





WaI 30 AjJedodd — STeTUS{eW pasussty 


wN2ZI JO STETUS{eW pazstuysey,, 


0-092T-82A1 


"(9% $O ST FACd) E O4NBTY 


"d4od WEI 2YBTYAde) (9) 


409S0904d INAAASAS 


L86T 


uo TPONpouzUT 


S2-WUS 


C C C 


information FE . £1 
SYSEVENT When Issued Routines Invoked eee me nvoked SRM Action iat rr Exit To 
Passed Returned outine 6 





CONFIGCH | ACONFIG e ASID. None None ehlabevioca read Yes SRM 
X'1D' command has been | @e SMF record interruptions. If « control 
29 issued for a describing the online, SAM checks for (IRARMCTL) 
channel or change. (pointed Me cet day 
processor. to by register 1) made ready. In addition, 


updates SRM control 
information for demand 

| paging thresholds for 
MPL adjustment. Recal- 
culates all processor 
execution time 
thresholds based on the 
number ofprocessors 
previously and presently 
online. 


The IPS is checked for 


— 




































VERIFYPG An interpreter has | @ Performance @ Valid (00)/ Yes SRM 









X'1E! received a per- group number. invalid (02 — performance group control 
30 formance group (register 1, TSO user ASID) number validity. If (IRARMCTL) 
number which bytes 2-3) indication the number is invalid, 
needs verification. (register 1, a default is provided. 
byte 2) 





















































































RESETPG The system e ASID. Retirn-codé Start new For users in real Starting a new trans- Yes SRM 
X'1F’ operator has @ New performance | indicating transaction storage, a new trans- action results in the Control 
31 entered a RESET grou) number. — request honored | (IRARMWMN). action is started. For user being associated (IRARMCTL) 
command for a (register 1, (00) swapped out users a with the performance 
particular address bytes 2-3) or new transaction is objective, domain, 


and dispatching 
priority control 
corresponding to the 
first period of the 


started when the 
swap in occurs. If 
workload reporting 

is active, IRARMWR6 


space. --perfOrmance 


group number 
invalid (04) 
ol 


















—ASID not is called to indicate performance group 
currently that a transaction has definition. 
assigned (08). ended. 

(register 1, 






byte 2). 


e@ Old IPS descrip- 
tion 


















































e ASID 
@ Pointer to WMST 
describing new 
IPS. (register 1) 


SRM 
Control 
(IRARMCTL) 


Set to new IPS 
(IRARMSET). 


NEWIPS 
X‘20' 
32 


The system 
Operator has 
entered a SET 
command with the 
IPS keyword. 


The IRARMSET 
routine is called by 
the IRARMIPS 
routine in 
IRARMEVT which 
is invoked indirectly, 
through the action 
request routine. 


If workload activity 
reporting is active for 
the measurement facil- 
ity, the reporting is 
terminated (it is re- 
established later by 
the measurement 
facility. A per- 
formance group 
number for each trans- 
action is assigned and 
a new transaction is 
begun. 
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SYSEVENT When Issued 


NEWIPS 
Cont'd, 
X‘20' 
32 


ALTCPREC | Asaresult of an 
X'21' error some processor 

33 has had to be 

configured out of 

of the system. 








e Address of the 
PCCA for the 
processor. 

(register 1). 


















Routine tnvoked 


ASCBCHAP 
standard 
interface 
(IRARMAP2) 
Create or free 
1/O load bal- 
ancing control 
blocks 
(IRARMLDB) 


Enable a pro- 
cessor for |/O 
interrupts 

(IRARMILG) 





Function of Invoked 
Routine 


If necessary, all address 
spaces currently in 
storage are given a new 
dispatching priority. 


If 1/O load balancing is 
active, the SRM creates 
control blocks to main- 
tain load balancing 
data. If load balancing 
is being turned off, the 
SRM frees these con- 
trol blocks. 





If a processor en- 

abled for |/O in- 
terruptions is 

moving offline, 

the SRM enables 
another processor for 
1/O interruptions. In 
addition, updates SRM 
control information 
for demand paging 
thresholds for MPL 
adjustment. Recal- 
culates all processor 
execution time 
thresholds based on the 
number of processors 
previously and presently 
online. 


control 
(IRARMCTL) 
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Function of Invoked SRM Lock Exit To 
Routine Held 


Starting a transaction Yes SRM 
results in the user being 
associated with the 
first period of his 

performance group. 





Information 


Famed [Rawr | 


e ASID. Start new trans- For TGET, indicates 

@ TGET (0) or action the start of a new 
TPUT (1) (IRARMWMN) TSO transaction. If 
indication. workload reporting 
(register 1, byte is active, TIRARMWR6 
0, bit 0). is called to indicate 

e (for TGET) entire that a transaction has 
message trans- ended. If the 
ferred indicator. TGETTPUT 
(O—all transferred; SYSEVENT was pre- 
1—at least one ceeded by a TERM- 
more TGET WAIT condition the 
required), IRARMWMN routine 
(register 1, byte is instead called at 
0, bit 0). the time the address 

space is swapped in. 









Routines Invoked 


SYSEVENT When Issued 































TGETTPUT 
X‘22' 
34 


A TGET OR TPUT 
instruction has 
completed some 
1/O to a terminal. 
















control 
(IRARMCTL) 













































Invoker via 
IRARMIO1 





The system start/ 
stop routine has 
been entered to 
stop the system. 


SYSOQSCT 
X'23' 
35 


The SRM saves the 
time at which the 
system was stopped. 






























Invoker via 
IRARMIO1 


Steps forward trans- 
action starting times 

by the duration of the 
system stoppage. 







SYQSCCMP 
X'24' 
36 


The system start/ 
stop routine is 
about to restart 
the system. 
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SYSEVENT When Issued 
























SETDMN The operator @ Pointer to the Return code 
X‘25' entered a SETDMN SETD parameter | (register 15) 

37 command to list (register 1). 0: Successful! 
change constraint 4: Invalid domain 
values fora 8: Minimum 
domain. exceeds 

maximum 
12: Invalid AOBJ 
or DOBJ value. 


16: SETOMN input 
is incompatible 
with the 

current IPS. 











e ASID. 

@ Address of 3-word 
return area. 
(register 1). 


e Return area for 

a TSO user: 

— Total service 
(word 1). 

— Total trans- 
action active 
time for all 
transactions 
(word 2), 

— Last per- 
formance group 
number (word 
3, bytes O & 1). 

— Total number 
of transactions 
(word 3, bytes 
2 & 3). 

e Return area for a 
non-TSO user: 

— Total service 
(word 1). 

— Total trans- 
action active 
time (word 2). 

— Last per- 
formance group 
number (word 
3, bytes O & 1). 

@ Indication 
whether data was 
successfully 
returned (00) or 

not (04). 

(register 15, 

byte 3). 


Issued by the TSO 
TIME command, to 
obtain user related 

service data. 


X'26' 
38 






















routine 
(IRARMWM'1). 


Routines Invoked Function of Invoked 
Routine 


Service calculation 






Update the domain 
descriptor table with 
the new values in the 
SETDMN command. 











Accumulated service 
information is stored 
in the user’s area 
(while not holding the 
SRM lock) and under 
the user’s protect key. 


Calculates the service 
accumulated during 
the current “in real 
storage” interval. This 
is added 10 previous 
accumulated service 
to obtain total service. 








SRM Lock) Exit To 
Held 


Invoker via 
IRARMIO1 


Invoker via 
IRARMIO1 
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When issued 


REQPGDAT 
X'27' 
39 


@ Return area: 
during step @ Address of 16 — Non VIO page- 
termination, to word return area. ins (word 1). 
obtain user paging (register 1). — Non VIO pege- 
data. @ Indicator of outs (word 2). 
This SYSEVENT is | whether the — Non VIO 
intended for SMF. related data reclaims 
Other callers must fields in OUSB oa d 3). ; 

; — VIO pege-ins 
not set the indi- and OUXB are (word 4) 
cator requesting to be reset to -VvIO pege ae 
that the related zero. (word 5). 
data fields in the — VIO reclaims 
OUSB and OUXB (word 6). 
be reset to zero. If — Pages swapped 
reset is requested in (word 7). 
by another caller, — Pages swapped 
the data is lost to = tape 8). 
ai (word 9). 
— Common ares 
page-ins 
(word 10). 
— Common ares 
reclaims 
(word 11). 
— Pages stolen 
(word 12). 
— LPA page- 
ins (word 13}. 
— LPA reclaims 
(word 14). 
— CPU page- 
seconds 
(words 15, 16). 
@ Indication 
whether data was 
successfully 
returned (00) or 
not (04). 
(register 15, 
byte 3). 





Routines invoked 


Function of invoked 
Routine 


The SRM obtains 
paging data fram SRM 
control blocks and 

if requested resets 
related fields in 

these blocks to 

zero. 


SRM 
Control 
(IRARMCTL) 
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SYSEVENT When Issued 






COPYDMDT 
X’28' 
40 


































Issued when a 
“DISPLAY’’ 
command with the 
keyword *’DMN” 
has been entered. 










DONTSWAP 
X'29' 
41 






issued to notify 
SRM that the 
issuing address 
space must not be 
swapped out unt! 
either an OKSWAP 
(2A) or INITDET 
(OB) SYSEVENT. 











Pointer to a fixed 
area to receive a 
copy of the domain 
table. (register 1). 


@ ASID. 


‘indicates whether 





Function of Invoked 
Routine 


Routines Invoked 


Pointer to same area 
(register 1). Word O 





nonswappables are 
counted in the 
CMPLs of domains 
(x'40') and whether 
the domain table is 
included (x‘80‘). 
Words 1 and 2 con- 
tain the time when 
displayed values 
were in effect. 
Words 3 and 4 
contain IPS parmlib 
member name. 
Words 5 and 6 con- 
tain OPT parmlib 
member name. 
Words 7 and 8 con- 
tain installation 
control specification 
parmlib member 
name. 

Word 9 and on — 
count of domains 
and domain table. 





















Determine SRM 
algorithms applicable 
to user, and reposition 
user on SRM swap 
queue. 


@ Indication 
whether request 
was honored 
(00), was not 
honored because 
it was not for the 
current address 
space (04), or 
was not honored 
because it was 

not authorized 

(08). (register 1, 

byte 3). 


Swap Status 
Change Request 
(IRARMWMK). 























Duplicate Domain 
Information 






SRM Lock 
E 
ak: ee ee 


Invoker Via 
IRARMIO1 


(IRARMCTL) 
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SYSEVENT 








OKSWAP 
X'2A' 
42 


REQSWAP 
X '2B ‘ 
43 


BRINGIN 
X'2C’ 
44 





Issued to notify 
SRM that issuing 
address space, which 
had previously issued 
a DONTSWAP 

SYSEVENT, may 
again be considered 
for swapping. 








Issued when a 
CONFIG storage 
command has 
been issued, to 
swap out the 
address space 
that occupies 
the storage to 
be taken offline. 


Issued when the 
system Operator 
has issued a 
CANCEL com. 
mand for a 
particular job. 






























e Indication 


e ASID. 





® ASID. 

e Address of ECB 
to be posted (if 
dependency 
exists on 


(register 1). 














requested swap). 


o ° 










SRM Lock 
Held Exit To 


Function of Invoked 
Routine 






Routines Invoked 















Same as for 
DONTSWAP (29). 


Swap Status 
Change Request 
(IRARMWMK). 


SRM 
Control 
(IRARMCTL) 











whether request 
was honored (00) 
was not for the 
current address 
space (04), or was 
not authorized 
(08). 

(register 1, byte 3). 








































SRM 
control 
(IRARMCTL) 


The region control 
task (RCT) is 
posted to begin the 
swapout. If swap 
completion notifi- 
cation is requested 
(by providing an 
ECB), the ECB is 
posted when the 
address space is next 
swapped in. 


Control swapout 
(IRARMCSO). 


e@ Indication 
whether the 
request is 
honored (00), 
was ignored 
because the 
address space 

is non-swappabte 

(04), or is 

ignored because 

the address space 
is in the process 
of swapout( OC). 

(register 1, 

byte 3). 


Initiates the swapout 
of the address space. 
(See Diagram SRM-12.) 



























































Invokes IRARMWMU 
to make the address 
space eligible for 
swap-in. 


SRM 
control 
(IRARMCTL) 


Expedite the swap-in 
of an address space 
that is swapped-out. 


Simulate user 
ready notification 
(IRARMHIT). 


Indication 
whether request 
is honored (00), 
or is not hon- 
ored because the 
address space 

is in the process 
of being swapped 
(08). (register 1, 
byte 3). 
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e ASID. e Indication 


Function of Invoked 
Routine 





Routines Invoked 





SRM Lock ; 
Held Exit To 


Yes SRM 


































NKLDINIT Issued by RMF to Workload activity Constructs and 

































X‘2D' request that SRM @ Data collection whether request recording initializes the work- control 
45 begin collecting buffer address. is honored(00), or] initialization load activity ({RARMCTL) 
(register 1) is not honored be-| (IRARMWR1). measurement table 


workload activity 
data. 






cause of incorrect (WAMT). 
buffer size (08), 
or data collection 
is already active 
(20). (register 


15, byte 3). 


@ Indication 
whether request 
was honored 
(00), whether an 
IPS change has 
Occurred (04), or 
data buffer had 
not yet been 
established (40). 
(register 15, 
byte 3). 


e Address of the 

















































WKDCOLL 
X'2E' 
46 







e ASID.. 

e Data buffer 
address. 

(register 1) 


Workload activity 
recording data 
collection 
(IRARMWR3). 


SRM 
control 
({RARMCTL) 


Moves the contents of 
the WAMT intoa 
collection bulfer. 


Issued by RMF at 
the end of a 
reporting interval, 
to collect work- 
load activity data. 









The SRM indicates 




















WKLDTERM | Issued by RMF to 







SRM 



















X'2F’ terminate work- buffer no longer that workload activity control 
47 load activity data used by SRM. data collection no (IRARMCTL) 
recording, at (register 1). longer be performed. 







e Indication 
whether the 
request was 
honored (00) or 
the data collec- 
tion buffer had 
not yet been 
established (40). 

(register 15, 

byte 3). 


RMF termination 
or when an IPS 
change has 
occurred. 




















































e ASID. 
e Address of 






SRM control 
(IRARMCTL). 


Issued by the SRM Performs control Frees up SRM Yes SRM 






48 Degree ee. Se dea mainline processing, SRB for reuse. control 
function must be ee a in the course of which (IRARMCTL) 
invoked immediate- register 1). 


a scheduled critical 
function will be 
performed (See 
Diagram SRM-7). 


ly (that is, without 
waiting for the next 
SYSEVENT issued 
by another 
component). 
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SYSEVENT When Issued Routines Invoked 


REQSVDAT | Issued by SMF e@ ASID. @ Return area for Service calculation 
x‘31' during job session e Address of 8 a user: routine 
49 termination to word return area — Total service (IRARMWM1) 

obtain user related (register 1) (word 1) 

service data. — Total trans- 
action active 
time (for TSO, 
the total of 
all transactions) 
(word 2) 

— Last perform- 
ance group 
number (word 
3, bytes 0&1) 

—TSO only: 
total number 
of transactions 
(word 3,bytes 
2 & 3) 

— Session 
residency 
time {word 4) 

— Session 
processor service 
(word 5) 

— Session 
IOC service 
(word 6) 

— Session 
MSO service 
(word 7) 

— Session 
SRB service 
(word 8) 

@ Indication 
whether data was 
successfully 
returned (00) or 
not (04) 

(register 15, 

byte 3) 


Function of 
invoked Routine 


Calculates the service 
accumulated during 
the current in real 
storage interval. This 
is added to previous 
accumulated service 
to obtain total service. 


Accumulated service 
information is stored 
in the caller's area 
under the caller's 
protect key. 


Exit To 


Invoker via 
IRARMIO1 





uW@I JO STETUOEW PEzZITWISeN, 


WAI $0 AjJedoud — STeTUEEW PeSuesty 


0-O09ZT-82Al +UBW Sey SAS :71S YWX/“SAW 5f-WHS 


‘d4uog WEI FYBTYAdOD (9) 


Le6l 


"(92 $9 22 FACd) F SINBTY 


40SS9904q INAAASAS 


SYSEVENT 


HOLD 
X'32' 
IRARMFIP 


50 







NOHOLD 
X'33' 
51 
IRARMEFIP 


NEWOPT 
X'34' 
52 













When Issued Information Hattines invoked Function of Invoked SRM Lock Exit To 
Passed Returned Routine Held 


Issued to notify Not applicable Increase the HOLD 
SRM that the count tn OUCB for 
issuing address 

must not be 

swapped out until 

a NOHOLD 

SYSEVENT (33) 

is issued. 

Issued to notify e ASID None Not applicable 

SRM that the 

issuing address 

space, which has 

previously issued 

a HOLD 

SYSEVENT, may 

again be considered 

for swapping. 
















Invoker 


this user. 
Note: 
HOLD/NOHOLD 
have a function 
similar to the 
DON TSWAP (29)/ 
OKSWAP (2A) 
SYSEVENTSs, but 
are faster. 


















Decrease the HOLD Invoker 
count in the OUCB 
for this user. When 
the count reaches 
zero the address 
space is again 
considered for 
swapping. 





































Issued when the The address of the | None Set to a new OPT Copy the OPT Call IRARMSOP SRM control 
system operator parameter list con- (IRARMSOP). parameters into to copy the values (IRARMCTL) 
has entered a SET taining the new various SRM from the parameter 
; Start or turn 
command with OPT constants. control blocks. list to the control 
he OPT keyword BiG ieee If 1/0 load 
the eyword. balancing es blocks. 
(IRARMLDB) uous as 


active, the SRM 
creates control 
blocks to main- 
tain load balancing 
data. If load bal- 
ancing is being 
turned off, the 
SRM frees these 
control blocks. 
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SRM Lock 
Held 


Function of Invoked 


SYSEVENT When Issued Routi Invoked : 


Exit To 


No Invoker 


TRAXERPT | Issued to report Pointertoa/72-byte | Indication of one Not applicable Calculate transaction 
X‘35' the completion of area containing of the following: elapsed time and save 
53 a subsystem trans- transaction start @ Whether the re- it with input in an 
IRARMEFIP_ {| action for which time, name, userid, quest was honored extended queue 
service data is class and subsystem (00) element. 


available. name as well as e If an immediate 
CPU time, SRB retry might 
time, MSO time and succeed (08) 
1/O count. e |f reporting is 
(register 1) temporarily 
suspended (12) 
e |f reporting is 
inoperative (16) 





TRAXFRPT (Same as for No Invoker 

























Save input data ina 








Pointer to a 40-byte 








Issued to report Not applicable 






X‘'36' the completion of area containing TRAXERPT 35) basic queue element. 
54 a subsystem transaction elapsed 
IRARMEIP action. time, name, user 





ID, class, and sub- 
system name 
(register 1) 






7 


7 

























TRAXRPT (Same as for Pointer to a 40-byte | (Same as for (Same as for No Invoker 







X‘37' event 36) area containing TRAXERPT 35) event 36) 
55 transaction start 
IRARMFE IP time, name, user 





1D, class, and sub- 
system name 
(register 1) 


@ ASID or ‘FFFF’ 




































DIRECTPO When a page is e Destination Direct page-out to No Invoker 























X'38' being removed (common) or indicator auxiliary storage or 
56 from real] storage. (virtual fetch) O — to extended extended storage on 
IRARMEFIP (register 0, byte storage criteria table. 
0-1) 4 — to auxiliary 
@ Page-out page storage 
indicator (register 15, 
0 — unchanged byte 3) 
1 — changed 






(register 1, byte O, 
bit 0) 
e@ Page type 
1 — page-out 
2 — virtual fetch 
(register 1, byte 3) 










a ee 
ee eee 





uWdIl JO STETASIEW P8ITIASSY,, 


WaI 30 AQZWedoOdd — STeTJ8eEW Paesusesty 


‘TIS WX/SAN 9S-WES 


"(92 $O bS FALEd) EF SANKGTY 


2USy Sey SAS 


0-O9ZT-82AT 


‘duod WAI FUST4AdOD (9) 


Le6T 


4A0SS9904d INAAASAS 


SYSEVENT When Issued 








ICSCHK To determine if 






X’3C’ the UADS should 
60 be examined to 
IRARMFIP validity check the 







logon performance 
group specification. 
~ NEWICS 

X‘3D’ 
61 


The operator has 
requested that a 
new set of instal- 
tation control 
specification pa- 
rameters be placed 
into effect. 






NEWICS 
X‘3E’ 
62 
continued 







CMDSTART 
X‘35’ 
63 











Issued by the TMP 
when a command 
processor is to be 
invoked using 
either ATTACH 
or LINK 

















SRM Lock 
Held 


Function of Invoked 


Routine 


SRM control 
(IRARMCTL) 





Routines Invoked 
Passed Returned 


Indication of 
whether TSO is 
specified in the 
installation control 
specification (00), 
or not (12). 





Examine the TSO bit 
in the installation 

control specification 
common section. 


Not applicable 



































































The new installation Yes 
control specification 
parameters become 
active in both con- 
trolling and reporting 


work. 


Inserts the address of 
the new installation 

control specification 
parameter table into 
the RMCT. 


Set new installation 
control specifica- 
tion parameters 
into effect 
(IRARMSIC) 


Address of the in- 
stallation control 

specification param- 
eter table previously 
in effect (register 1) 


Address of the new 
installation control 
specification con- 
trol parameters 
(register 1) 



























































If workload activity 
reporting is active, 
the reporting is 
terminated. 














IRARMFPG Assign report and 
control performance 
groups using the new 
installation control 


specification tables. 










IRARMWMN 
















Start a new trans- 
action if the user 
switched control 
performance groups. 
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Yes 


For time 


Address of the IRARMFPG 
command start 


parameter list 








The process of start- 
ing a new transaction 
results in a user being 
associated with the 
first period of the 
associated perform- 
ance group. 


If not processing a 
CLIST, assign report 
performance groups 
from the installation 
control specification 
using the new trans- 
action name. 






sharing ad- 
dress spaces, 
exit to SRM 
control 
(IRARMCTL) 




















For non-time 







sharing ad- 
dress spaces, 
exit to the 
caller 
(IRARMIO1) 


Start new trans- 
action 
(IRARMWMN) 







If processing a 
CLIST and the instal- 
lation requested that 
each command be 
treated as a new 
transaction, start a 
new transaction. 
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Function of Invoked SRM Lock 


Not applicable If the command is not 
from a stack or did 
not change the stack, 
set indicators to stop 
counting for the com- 
mand and clear its 
transaction name. 


Enable a processor a Establish fast workload 


SYSEVENT When issued 
seaeven 


CMDEND When a TSO com- e ASID 

X‘40’ mand is completed. | e@ Stacking command 
64 indicator: 

IRARMF IP — 00 — This com- 
mand did not 
change the 
stack 

— 08 — This com- 

mand added 

one or more 
mands to the 
stack 














































When takeover Yes 


is in progress 





WKLDCHG 
X'41' 
65 















for 1/O interrupts acceptance for the 
(IRARMIL6) specified address space 






4 
ee 






























































MIGCNSTR | When RSM can’t e@ Status indicator @ Override indicator Not applicable Determine if storage Yes 
X'42' find enough ex- (01—shortage in shortage case isolation should be 
66 tended storage 02—relieved) 00—override stor- overridden. 
frames to migrate (Register 1, byte 3)} age isolation 
or this shortage is 04—don’t override 
relieved. (Register 15, 
byte 3) 
MISPURGE | When there is a @ ASCB or zero Not applicable Look for pages to Yes 
X'43' shortage of ex- eo Number of pages migrate: 
67 tended storage and ‘ to migrate e@ Deferred migration 
some needs to be e Number of pages swaps 
freed. to be converted e Address spaces on 
and freed auxiliary storage 
with pages on ex- 
tended storage 
@ Isolated address 
spaces above 
maximum. 
MIGSWAP When RSM attempts] @ ASID e Number Of frames | Control swap-in Swap the address If address space is not Yes 










(IRARMCSI!) 


about to be swapped 


x'44' to swap a primary e@ Type of swap code being migrated (or space in 



















68 working set. — bitte zero). OUCB reposition. | Switch to appropriate oe it now or 
a . r. 
extended ing (IRARMRPS) queue 
2 — age 
e@ Number of frames 






being migrated 
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SYSEVENT 






SOUTSUSP 
X‘45' 
69 





UCBCHG 
X'46' 
70 


DDR 
X'47' 
71 


CHANNEL 
X'48' 
72 















When swap-out is 
suspended because 
of a shortage of ex- 
tended storage 

frames. 


When a VARY 
command is issued 
to place a device 
online or offline, 
or a CONFIG 
command is issued 
to place a channel 
path online or 
offline. 


When a SWAP 
command is issued. 





When the channel 
reports an error in 
the measurement 

facility. 


















e ASID 


Address of the UCB 
(register 1) 





















Address of a param- 
eter list with for- 
ward and backward 
pointers to the 
UCBs. 


Address of the 
channel facility 
report block 
(CFRB) (register 1). 















e Swap-out 
indicator 

OO — defer 

04 — terminate 


None 
























Routines Invoked 


Determine the 
logical path index 
for a device 
(IRARMLPI) 






Determine the 
logical path index 
for a device 
(IRARMLPI) 


Stop channel 
measurements 
(IRARMMSP) 


Not applicable 





















Function of Invoked 
Routine 


Calculate the index 
to the logical path 
block corresponding 
to the current set of 
channel paths to each 
device. 


Calculate the index to 
the logical path block 
corresponding to the 
current set of channel 
paths to each device. 


Turn off the channel 
measurement facility, 
signal the operator, 
and issue an ENF 
signal. 














SRM Lock 
Held Exit To 


Tell RSM to swap Invoker 
to auxiliary or 
suspend. 


=e 


online, build a data 
collection block for it. 









If the device is going 
offline, free its data 
collection block. 

















Update the logical 
path index in the con- 
trol block correspond- 
ing to each of the 

two devices. 










Stop the collection of 
channel measure- 
ments. If the error is 
temporary, ensure 
that measurements 
are started again after 
a 16-second delay. 
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AND QUEVES 


The main control block table for the SRM is the resource manager 
control table CRMCT). The RMCT, which resides in the nucleus 
resident module IRARMCNS, is located by a pointer in the CVT 
CCVTOPCTP). (See "Control Block Overview" later in this book. ) 
IRARMCNS also contains the following: 


@ Control tables used by processor, I/0, storage, and resource 
management routines 

e Constants used by the control algorithm to determine the 
criteria and frequency of swap analysis 

@ Tables describing the entry points for various SRM routines, 
algorithms, and event-initiated actions 


The state of each address space is described by the user 
indicators in the corresponding SRM user control block COQUCB). 
(See "Individual Wser Indicators" later in this book.) Each 
OUCB resides on ore of four QUCB queues, which correspond to 
categories of address spaces. When the state of an address 
space changes, the OQUCBGOB bit is set in its OUCB, and the OUCB 
reposition routine is called to move the OUCB to the queue and 
position which reflects its new state. 


A description of each category of address space, corresponding 
to the four OUCB queues follows. 


@ IN - The address space contains ready work. It 1s swapped in 
and actively completes for system resources. 
e OUT - The address space contains ready work. It does not 


actively compete for system resources because it is 
logically swapped out (I/0 operations are quiesced) or 
physically swapped out (resides on auxiliary or extended 
storage). The address space is eligible for swap-in. 

e Logical Swap WAIT - The address space does not contain ready 
work, and is logically swapped out. The address space is 
not eligible for swap-in. 

e WAIT - The address space is physically swapped out, and is 
not eligible for swap-in because 
- It contains no ready work, or 
- It was swapped out to relieve a resource shortage, or 
- Swap-in failed too many times. 


The SRMDATA format control statement of PRDMP Cprint dump) and 
IPCS and the CBFORMAT command of IPCS can format the OUCBs on 
these four queues. The CBSTAT command of IPCS can also analyze 
an OUCB for important information. SRMDATA also formats the 
idle table CDMDT), which indicates the swapping status of the 
system. 


If an address space is being swapped in (bit OUCBGOI is on) or 
swapped out (bit OUCBGOO is on), or is about to change queues 
(bit OUCBGOB is on), its position on the OUCB queue may not 
reflect its current status. When a swap completes (successfully 
or unsuccessfully), the OUCB is repositioned to reflect its 
current status. 


The primary address~space-related control block is the OUCB, 
which holds much of the information about the state of an 
address space. For swapped-in users, other information exists in 
the SRM user extension block (COUXB). CNote that both the OUCB 
and the OUXB are mapped in IRARMCNS). If an address space is 
swapped out, an SRM user swap block COUSB) built in LSQA saves 
some of the data that the OUXB of the address space contained. 
The OUSB is swapped out with the address space. 


When the OUCB reposition routine is called, it examines the user 
indicators for the address space to determine the queue and 
position which reflects the address space's status. The 
following tests are made in succession to determine the state 
and placement of the OUCB. 
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OUCBOUT="O'B The address space is swapped in and the 
OUCB is placed at the end of the IN queue. 









OUCBRDY='1'B 
OUCBAXS="0'B 
OUCBFXS="0O'B 


The address space is eligible for 
Swap-in and the OQUCB is 
placed at the end of the OUT queue. 


OUCBJSAS="'0'B 
OUCBJSFS="0'B 
OUCBCSFS="0'B 


OUCBMGSW='1'"B A migration swap for the address 
space has been deferred and the OUCB is 
placed at the beginning of the WAIT queue. 
OUCBLSW="O'B The address space is physically 
swapped out and the OUCB is placed at the 
end of the WAIT queue. 


OUCBESSW='1'"B A swap-out to extended storage 


for the address space has been deferred 

and the OUCB is placed at the beginning 
of the logical swap WAIT queue. 

All others 

When repositioning is completed COUCBGOB bit is turned off), the 

following queue conditions are met. 































The address space has been logically 
swapped by think time and the OUCB is 
placed at the end of the logical 

swap WAIT queue. 


e A swapped-in address space can only be on the IN queue. 


e A logically~swapped address space can be on the logical swap 
WAIT queue or the OUT queue. 


e An address space that is swapped out can be on the WAIT 
queue, the logical swap WAIT queue, or the OUT queue. 


e An address space for which a migration swap has been 
requested can be on the WAIT queue or the OUT queue. 


@ A swapped-out address space can be on the WAIT queue or the 
OUT queue. 


e An address space being swapped in can only be on the OUT 
queue. 
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The setting of the swap transition flags for swap-out processing 
occurs in the following order. 


e If swap-out is initiated successfully the OUCBGOO bit is 
turned on. 


e The OUCB is repositioned and the OUCBGOO bit is turned off 
at quiesce complete for a logical swap-out and at swap-out 
complete for a physical swap-out. 


The setting of the swap transition flags for swap-in processing 
occurs in the following order. 


e If swap-in is initiated successfully, the OUCBGOI bit is 
turned on. 


e The OUCB is repositioned and the OUCBGOI bit is turned off 
at restore complete for a logical swap-in and at swap-in 
status 2 for a physical swap-in. 


The setting of the swap transition flags for migration swap 
processing occurs in the following order. 


e If the migration swap is initiated successfully, the OQUCBGOO 
bit is turned on. 


e At swap-out complete, the OUCBGOO bit is turned off, and the 
OUCB is repositioned if it is on the WAIT queue. 


SRM control is the dispatcher of the SRM. It resides in the 
module IRARMCTL along with various other SRM routines. Most 
SYSEVENTs that execute holding the SRM lock exit to SRM control 
to perform the following functions: 


e SRM control executes deferred actions Croutines that execute 
on behalf of a single user). Examples of actions are: 


= Moving a user control block from one SRM queue to 
another 
- Memory delete processing 


e SRM control executes deferred algorithms Croutines that 
execute on behalf of the entire operating system). Examples 
of algorithms are: 


_ Page replacement 
= Real page shortage prevention 


e Following the TIMEREXP SYSEVENT, SRM control schedules timed 
algorithms. Examples of timed algorithms are: 


= Assigning swappable users their current workload level 
(swappable user evaluation algorithm) 


- Keeping the multiprogramming level (MPL) at its target 
level in each domain by performing user swaps (swap 
analysis algorithm) 


SCHEDULING 


Actions and algorithms can be requested and scheduled by any of 
the components of the SRM. Request handling subroutines within 
IRARMCTL deal with these requests. Requests for actions are 
processed in one of the following ways: 


e The action is called inline if the SRM lock is held and if 
the action was not requested by another action. 


e Otherwise, the action is deferred. To indicate that the 
action was requested, a flag is set in the OUCB. 
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Requests for algorithms are always deferred, but, to indicate a 

request, a flag is set in the RMCT. If a deferred action or 

algorithm is considered critical, the request-handling } 
subroutine schedules an SRM to another entry point, IRARMCED 

Cwithin IRARMCTL). IRARMCED executes SYSEVENT X'30'. SYSEVENT 

X'30" exits to SRM control, which then executes the deferred 

action or algorithm. 


Non-critical actions and algorithms, requested but deferred, 
execute during the next pass through SRM control. This execution 
normally occurs after the processing of the next SYSEVENT that 
holds the SRM lock. 


SRM control identifies the actions and algorithms to execute by 
examining bit strings in the OUCB (for actions) and the resource 
manager control table CRMCT) Cfor algorithms). Bits set to 1 in 
the OUCB COUCBACN field) and in the RMCT CRMCTALA and RMCTALR 
fields) identify deferred action and algorithm requests 
respectively. 


The actual addresses of the individual routines that process 
actions and algorithms are located in resource manager entry 
point elements CRMEPs), which are chained together. One RMEP 
chain exists for actions and another for algorithms. SRM control 
compares the bits set to 1 in the bit string (the OUCB or RMCT) 
with each RMEP in the action/algorithm RMEP chain. When a match 
occurs, the entry point address in the RMEP identifies the 
action or algorithm routine that will get control. 


As part of routing control to the identified routine, SRM 
control turns off the bit in the OUCB or RMCT used to find the 
appropriate RMEP. When all bits in the OUCB and RMCT bit strings 
are off, SRM control has processed all deferred actions and 
algorithms and exits to a return point in the SRM interface 
module IRARMINT. Figure 4 and Figure 5 show in more detail the 
routines and bit settings used to process algorithms and 


actions. ) 
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REQUESTING SCHEDULING EXECUTING 
SRM Lock Scheduling RMEP Bit SRM Lock Executing RMEP 
Held Routine Chain String Held Routine Chain 














ACTIONS TRARMCRN EPDT OUCBACN YES CIRARMCEN, EPDT 


IRARMCRT ) 


{YES CIRARMCEL, EPAT} 
ITRARMCRT ) 


YES CIRARMCEL, EPAT 
IRARMCRT ) 

























TRARMCRL 
TRARNCRL 


IRARMCET 


EPAT 
EPAT 


RMCTALA 
RMCTALR 


MCTALR 













R 
ITRACTMQE 






1If SRM lock is held when an action is requested, it is not 
deferred except where an action invokes another action. Control 
passes to IRARMCRY if the action iss IRARMCSI or IRARMCSO or to 
IRARMCRN for all all other actions and then directly to the action. 









“During execution this field is inspected only in OUCBs 
that have been queued by the action-scheduling routine CIRARMCRN). 






Figure 4. Processing of Actions and Algorithms in IRARMCTL 


LY28-1760-0 (Cc) Copyright IBM Corp. 1987 Introduction SRM-43 


RMEPFLG 


*IRARMIL1 
*IRARMCL1 
*IRARMSQA 


IRARMMS5 
*IRARMAP1 


*“|IRARMPR1 


“IRARMEQ!1 
*IRARMMS4 
*IRARMVPD 
*IRARMASM 


*IRARMMS6 


IRARMPR5 
*IRARMIL5 
*IRARMCSF 

IRARMMS2 


*IRARMRM1 
*IRARMRM2 
*IRARMWM2 
*IRARMCAP 


IRARMAP2 
*IRARMWMB 





*indicates timed algorithm 


RMEPFLG 


IRARMDEL 
IRARMUXB 
IRARMIL4 
IRARMPRQ 
IRARMSWI 
IRARMHIT 
IRARMRPS 


Figure 5. 
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tf 


Critical 
timed 


= 0 (algorithm) 


Attributes 


Attributes 


SS 





Tht 


RMEP Algorithms and Action Invocation Flags 





Sys Res Mgmt 


Critical 


ZA 


AAPSPPPPA AD 


timed (algorithms only) 
= 1 (action) 
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SWAP ANALYSIS 


The swap analysis algorithm, which resides in the module IRARMSWP, attempts to 
maintain the multiprogramming level (MPL) at the target value in each domain defined 
to the system. A domain is a group of user address spaces, defined in the 
installation performance specification CIPS), that have common execution 
characteristics; for example, all TSO users might be assigned to one domain. The MPL 
in a domain is the number of users in that domain who occupy real storage. The 
target MPL is the number of users in real storage that the SRM resource monitor has 
determined to be optimal for this domain. 


The decision to swap an address spaces is made on the basis of a number of input 
factors supplied by other SRM functions. The workload manager provides workload 
levels for each user. The resource-use algorithms point to significant users of 
system resources. Swap analysis combines the individual recommendations of the 
workload manager and resource manager into a composite recommendation value CRV). 


When a swap-in is considered desirable, IRARMSCI initiates the swap-in by scheduling 
IARSIN in the real storage manager (RSM) and passing a parameter list containing the 
address of the ASCB. If not enough available frames exist, IARSIN notifies the SRM 
through a SYSEVENT CSWINFL) to try the swap-in later. When a swap-out is considered 
desirable, IRARMCSO initiates the swap-out by posting the region control task (RCT), 
which calls IARSOUT, the RSM swap-out routine. 


The following numbered paragraphs describe the sequential steps in the swap analysis 
algorithm. During step 2 and step 4@ all domains are considered in numerical order. 
The algorithm terminates at the end of any step that causes at least one swap. 


1. Defer swap-in. Based on the amount of storage available, the maximum number of 
deferred express users is swapped in (an express user is a user enqueued on a 
resource, a nonswappable user, or a user being cancelled). If enough storage 
exists for all deferred express users to be swapped in, then as many deferred 
non-express users as possible are also swapped in. If a deferred user cannot be 
swapped in and the swap has been evaluated for a period of ten seconds, the 
address space is placed in defer status on the WAIT queue. The system operator 
is then notified of the swapping failure and the storage requirements for the 
address space. 


2. Unilateral swap-out. In each domain, the required number of user address spaces 
are swapped out to lower the MPL to its target value. In each domain, the user 
with the smallest recommendation values (RVs) are selected for swap-out. 


3. Express swap-in. If any express users are swapped out, the express user who has 
been swapped out for the longest time is swapped in. if not enough storage 
exists for the swap-in, the steal thresholds are temporarily raised and the 
swap-in is deferred until the next invocation of swap analysis. If no user is 
swappable, the MPL in that domain temporarily exceeds its target. 


4. Unilateral swap-in. In each domain, the required number of user address spaces 
are swapped in to raise the MPL to its target value. In each domain, users who 
have the largest RVs are selected for swap-in. If not enough storage exists for 
@ swap-in, the steal thresholds are temporarily raised and the swap-in is 
deferred until the next invocation of swap analysis. 


5. Exchange swap. For a domain with an MPL that matches its target, an 
in-real-storage address space and an out-of-real-storage address space are 
selected for exchange. The user in real storage with the lowest RV and the user 
out of real storage with the highest RV are selected. The exchange proceeds only 
is the difference in their recommendation values exceeds a certain limit 
(specified in RMPTXCHT). If an exchange is justified, the swap-out of the real 
in~real-storage user is initiated, and the swap-in of the out-of-real-storage 
user is deferred until a subsequent invocation of swap analysis. 


The following method-of-operation diagrams describe important routines within 
IRARMCTL and IRARMSWP that relate to the swapping of address spaces. 


e Swap analysis CIRARMCAP), analyzes users and, if it determines a swap desirable, 
request it 


e Control swap-out CIRARMCSO), initiates requested user swap-outs. 


e Control swap-in CIRARMCSI), initiates requested user swap-ins. 
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e User selection for swap-in CIRARMCPI), finds the user with the highest 
recommendation value (RV) in its domain. | 


e User selection for swap-out CIRARMCPO), finds the user with the lowest 
recommendation value (RV) in its domain. 


e User evaluation CIRARMCVL), calculates a recommendation value (RV) for a 
specific user. 
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OURCE UV GO M 


To improve overall system resource utilization, the resource use algorithms provide 
functions that promote the efficient management of storage, I/0, and processor 
capabilities. The resource monitor records system information that benefits the 
performance of these functions. 


STORAGE MANAGEMENT 
The following functions promote the effective management of storage: 


Page replacement 

Real page shortage prevention 

Auxiliary slot shortage prevention 

SQA shortage prevention 

Pageable real storage shortage prevention 
Storage load balancing 


Page Replacement 


This function Centry point IRARMPR1 in module IRARMSTM) maintains a current record 
of the frames that have gone unreferenced for the longest period of real time and 
the age of the oldest unreferenced frame in the system. Invoking the real storage 
manager's CRSM) UIC update routine, IARXUU, at periodic real time intervals, 
accomplishes this function. At each invocation, IARXUU increases the unreferenced 
interval count CUIC) for those frames unreferenced since the last IJARXUU invocation. 
If IARXUU finds that an allocated frame was referenced during the last interval, it 
resets the UIC to zero. When the page replacement algorithm completes updating the 
UICs for all allocated frames, it saves the highest UIC in the system for use by the 
real page shortage prevention algorithm and the resource monitor algorithm. 


Real Page Shortage Prevention 


The SRM invokes this function Centry point IRARMMS2 in module IRARMST2) periodically 
to manage logically sSwapped users. If the available frame queue is below the logical 
Swap available frame target, eligible logically swapped users are swapped out to 
meet the target. The function is also invoked when the available frame queue falls 
below the available queue LOW threshold CRCEAFCLO). When the real page shortage 
prevention algorithm is notified of a real page shortage, the SRM steals frames from 
all users and the system pageable area (SPA). It steals the oldest unreferenced 
allocated frames in the system, starting with those showing the highest UIC (as 
saved by the page replacement algorithm), until the count of available frames plus 
the count of the stolen pages exceeds the available frame queue OK threshold 
RCEAFCOK). If the installation specified real storage isolation in the IPS, the 
steal process does not violate the target working set size for the common area or 
for an address space protected by storage isolation. Thus, the SRM could steal a 
page not protected by storage isolation even when the page has a lower UIC than 
protected pages. 


Auxiliary Slot Shortage Prevention 


At periodic intervals, this function Centry point IRARMASM in module IRARMCTL) 
checks for two levels of auxiliary slot shortages. Reaching the first level 
threshold causes (1) the prevention of address space creation, (2) the swap-out of 
the batch user who is acquiring auxiliary storage slots at the greatest rate, and 
(3) the delay of newly-initiated jobs. 


Reaching the second level threshold causes the swap-out of the batch user acquiring 
auxiliary storage slots at the next greatest rate. Messages to the operator indicate 
the occurrence of either shortage level. When this function detects an alleviation 
of auxiliary slot shortage, a message to the operator also indicates that fact. 
Address spaces can again be created, and those users swapped out to relieve the 
shortage regain eligibility for swap-in. 
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SQA Shortage Prevention 


The virtual storage manager (VSM) invokes this function Centry point IRARME25 in 
module IRARMEVT) when it detects a shortage of system queue area (SQA) space. This 
function prohibits the creation of address spaces for the duration of the SQA 
shortage and notifies the operator of the existence and severity of the shortage. 
When VSM anforms this function that the SQA shortage has been relieved, the operator 
receives a message to that effect and the system resumes the creation of address 
spaces. 


Pageable Real Storage Shortage Prevention 


The real storage manager (RSM) invokes this function Centry point IRARMMS2 in module 
IRARMST2) when the percentage of fixed frames (below 16 megabytes) to total frames 
(below 16 megabytes) exceeds a pre-defined limit. This function can: 


1. Prohibit the creation of address spaces 


2. Initiate a swap-out of the swappable user who owns the greatest number of fixed 
frames 


3. Physically swap some or all logically Swapped users 
4. Delay newly-initiated jobs 
5. Lower target MPLs for some or all domains 


The operator is notified of the existence and severity of the pageable storage 
shortage and of the identify of the swapped users. When this function detects 
alleviation of the shortage, a message to the operator indicates that fact. Creation 
of address spaces can continue, and those address spaces swapped out to remedy the 
shortage regain eligibility for swap-in. 


Storage Load Balancing 


This set of routines monitors the real storage use of address spaces specified by 
the installation. If the routines consider real storage underused or overused, this 
function recommends address spaces for swap-in or swap-~out based on their effect on 
the resource. Because it is scaled, the storage load balancer recommendation never 
exceeds one fifth of the highest possible workload level of the IPS currently in 
effect. This recommendation is multiplied by the MSO resource factor coefficient 
specified in the IEAOPTxx SYS1.PARMLIB member currently in effect. 
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I/O MANAGEMENT 
The following functions promote the effective management of I/0 resources: 


e Device allocation 
e I“0 load balancer swap analysis 
e Selective enablement 


Device Allocation 


This function makes device allocation decisions based on I/0 load balancing 
considerations when a choice must be made among device candidates. IRARME28& in 
module IRARMEV2 includes this function. The device allocation function applies the 
following rules (in the order indicated) to the candidates: 


1. If the request is for a tape, eliminate all candidates on ready devices 
Celiminate premounted tape drives) and on devices that contain passed volumes. 


2. Choose the candidate on the logical path (the set of physical paths to a device 
or group of devices) with the lowest use. The level of use takes into account 
any data sets previously allocated to a device on the logical path. 


3. Choose the direct access candidates with the lowest average delay per request. 
Choose the tape candidates based on the SELTAPE Keyword specified in the 
IEAOPTxx SYS1.PARMLIB member currently in effect. The options are: 


e The next highest device number from the last allocated device (default) 
e The first device number in the candidate list 

e The lowest device number in the candidate list 

e Random selection from the candidate list 


4. From a list of equal candidates, choose none at random. 


Ensure that the selected candidate device has not been previously allocated to 
the same user. 


I/O Load Balancer Swap Analysis 


This function consists of a set of routines that monitor the I/O logical path use of 
certain users and recommend users for swapping based on the extent to which the 
Swap-in or swap-out would correct a detected I/O imbalance. The I/0 load balancer 
recommendation is scaled, never exceeding one-fifth of the highest possible 
work-load level of the IPS currently in effect. This recommendation is then 
multiplied by the IOC resource factor coefficient specified in the IEAOPTxx 
SYS1.PARMLIB currently in effect. 


Selective Enablement 


To permit the enablement of the fewest processor without incurring delays in I/0 
interruption activity, this function controls the number of processors enabled for 
I/0 interruptions. Processors are enabled or disabled as necessary to maintain the 
interruption processing rate between thresholds specified in the IEAOPTx~x 
SYS1.PARMLIB member currently in effect. To make its decision, the SRM divides the 
number of interruptions processed through the test pending interrupt ¢€ PI) 
instruction by the total number of I/0 interruptions and compares the resultant 
percentage to the thresholds. If the percentage exceeds the upper limit, another 
processor (if available) will be enabled. If the percentage falls below the lower 
limit Cand more than one processor is enabled), a processor will be disabled. In 
addition, if an enabled processor is taken offline or fails, this function enables 
another processor. IRARMIL5 and IRARMIL6 in module IRARMIOM perform this function. 
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CPU MANAGEMENT 
The following functions promote effective processor management: 


e Automatic priority group CAPG) management 
e ENQ/DEQ algorithm 
@ CPU load balancer swap analysis 


Automatic Priority Group (APG) Management 


The SRM maintains control over one or more contiguous sets of 16 priorities. Within 
each set of 16 priorities, the SRM uses two distinct priority schemes, enabling the 
installation to exercise pretise control over the rules governing the dispatching of 
work. Users fall into one of two priority categories: 


@ Users with dispatching priorities based on the user's mean execution time before 
entering a wait state. This wait is defined as any time a task issues a WAIT, 
goes into page wait, or enters terminal wait, and no other ready tasks occupy 
this address space. Users who quickly release the processor obtain a high 
dispatching priority within the set of priorities governed by this scheme. 


e Users with fixed priorities, defined by the installation. 


ENQ/DEQ Algorithm 


This function inhibits the swap-out of users who control (Care enqueued on) resources 
that other system users need. Swap-out is prevented until the user releases the 
resource or the user has executed for the interval specified in the enqueue 
residence value CERV) installation tuning parameter. 


CPU Load Balancer Swap Analysis 


This function consists of a set of routines that monitor the system-wide processor 
load. They recommend users for swapping when the system is underused or overused and 
when users exist who would improve the balance by being swapped in or out. The CPU 
load balancer's recommendation is scaled so that is never exceeds one-fifth of the 
highest workload level that the IPS makes possible. This recommendation is then 
multiplied by the CPU resource factor coefficient specified in the IEAOPTxx 
SYS1.PARMLIB member currently in effect. 


RESOURCE MONITOR 


At periodic intervals, this function samples indicators of system resource and 
domain contention, including response time objective (RTO) domains associated with 
TSO transactions. The resource monitor uses this information to calculate system and 
domain contention factors. Based on these factors and thresholds 

specified in the IPS or the IEAOPTxx SYS1.PARMLIB member, the resource manager might 
do the following to ensure maximum resource use: 


Adjust domain target MPLs 

Adjust the system MPL 

Adjust the system maximum think time for logical Swapping 

Adjust the allocation of double frame pairs to provide an adequate supply on 
RSM's queue 

e Adjust extended storage available thresholds 


WORKLOAD MANAGEMENT 


The workload manager is a collection of subroutines that perform three main 
functions: 


1. Monitoring the rate at which system resources are being provided to individual 
address space. 


2. Providing the swapping recommendations (Cbased on installation specifications and 
resource use) that SRM control CIRARMCTL) requests. 


3. Collecting data for Resource Measurement Facility CRMF) workload activity 
reporting. 
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Subroutines that perform the first two functions reside in the workload manager 
modules, IRARMWLM and IRARMWLS. The data collecting subroutines that perform the 
third function reside in the workload activity recording module, IRARMWAR. The 
workload manager does not control nonswappable address spaces and certain privileged 
system control program functions. 


In providing swapping recommendations to SRM control, the workload manager affects 
the relative rates at which processing resources are provided to active address 
spaces. By comparing the resource use (service rate) for an address space with the 
installation performance specifications, the workload manager computes the workload 
level Cthe workload manager recommendation value) for the address space. SRM control 
uses this value as a swapping recommendation. 


The workload activity recording CIRARMWAR) collects data for RMF when the 
installation requests workload activity reports. The workload manager and the 
SYSEVENT processor periodically invoke IRARMWAR to collect data for placement in the 
workload activity measurement table CWAMT). The workload reports are based on the 
data in the WAMT. An installation can analyze these reports to determine the 
appropriate installation performance specification parameters to meet its needs. 


IRARMWLM and IRARMWLS perform the following tasks to support workload management 
functions: 


e Swappable user evaluation. 


@ IN queue and OUT queue scanning-evaluating each non-privileged swappable user 
and asSigning a current workload level. 


® Individual user evaluation-evaluating a single non-privileged swappable user and 
assigning a current workload level. 


@ Transaction reporting for a subsystem-collecting transaction data provided by 
various subsystems for RMF reporting. 


@ User ready processing-initializing user control blocks and repositioning the 
user from the WAIT queue to the OUT queue so that the user becomes eligible for 
swap-in. 


IRARMWAR performs the following tasks to support the data collection functions of 
the workload manager: 


e WAMT initialization-updating the workload activity measurement table CWAMT) with 
information from the workload manager specification table (WMST). 


e WAMT reinitialization-copying the WAMT data to a temporary buffer and then 
updating service values and workload levels. 


e ICSM initialization-building the installation control specification map CICSM). 
The ICSM is a mapping of performance group numbers with their corresponding 
installation control specification names. RMF uses the ICSM to include the names 
in its workload and transaction reports. 
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AG IQUES 


BUGG NT 


Various system and user indicators supply valuable information for diagnostic and 
debugging procedures. Useful fields exist in SRM data areas, user control blocks, 
and system diagnostic work areas. 


USEFUL FIELDS 


To assist in problem analysis, especially in enabled wait situations, it is helpful 
to understand how the SRM views the total system, as well as the individual address 
spaces. The counters and flags that pertain to the entire system are located in 
fields of data areas in IRARMCNS. The counters and flags that pertain to an 
individual address space are found in the fields of that user's OUCB. 


System Indicators 


The SRM control table (RMCT) is located at the start of module IRARMCNS. Its address 
is found in the field CVTOPCTP of the CVT data area (CVTt+X'25C'). Generally, when 
the SRM is in control, register 2 holds the address of the RMCT. Through its fields, 
the RMCT points to other fields that contain information about the SRM's current 
processing. For the anchors and locations of the following fields, see the Debugging 
Handbook. 


Useful system indicators include the following fields: 


MCTAVQ1 This bit indicates that the count of available pages has fallen below 
the available frame queue LOW threshold CRCEAFCLO)} value, so the real 
storage manager (RSM) has called the SRM to steal pages in order to 
increase the count of available pages. This condition is normal. 


MCTSQA1 This bit indicates that the number of available SQA pages is critically 
low. Message IRALOOI is issued to the operator and MCTSMS1 is set to l 
to indicate that the message has been issued. 


MCTSQA2 This bit indicates that the number of available SQA pages has fallen 
below a second, more critical threshold than the one noted in MCTSQAl. 
Message IRALOI1I is issued to the operator and MCTSMS2 is set to 1 to 
indicate that the message has been issued. 


MCTASM1 This bit indicates that the SRM has detected that less than 30% of all 
local auxiliary storage slots are available. The SRM has informed the 
operator of this fact through message IRAZ00I, and has taken 
appropriate action to relieve the shortage. 


MCTAMS2 This bit indicates that the SRM has detected that less than 15% of all 
local auxiliary storage slots are available. The SRM has informed the 
operator of this critical slot shortage, through message IRA2Ol1I and 
has taken appropriate action to relieve the shortage. 


MCTFAVQ This bit indicates that the SRM or the RSM has detected a pageable 
storage shortage condition. If the MCTLGPSS bit is set to l, the SRM 
detected the shortage. That is, the sum of the number of fixed frames 
and the number of page I/O operations in progress to the page data sets 
exceeded the threshold set in MCCMAXFX. If the MCTPHPSS bit is set to 
l, the RSM detected the shortage. That is, the count of fixed frames 
CRCETOTFX for all fixed frames, RCEBELFX for fixed frames below 16 
megabytes) exceeded the threshold set in RCEMAXFxX. 


MCTLGAVQ This bit indicates that the SRM has increased the threshold values set 
in RCEAFCLO and RCEAFCOK Cavailable frame queue thresholds) to initiate 
the frame stealing necessary to swap in an address space rather than 
wait for the SRM to issue an AVQLOW SYSEVENT. 
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RCVUICA 


RCVCPUA 


RCVDPR 


RCVMSPP 


RCVFXIOP 


RCVMFXA 


RMCAINUS 


CCVENQCT 


LSCTCNT 


LSCTCNTW 
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This halfword contains the target working set size for the common area. 
The SRM attempts to keep at least this minimum number of frames 
asSigned to the common area. 


This halfword indicates the average high unreferenced interval count 
CUIC) that the resource monitor detected at the last interval. Based 
on this value, the target MPL for a domain might be altered. 


This halfword indicates the average processor utilization that the 
resource monitor detected at the last interval. Based on this value, 
the target MPL for a domain might be altered. 


This halfword indicates the demand paging rate that the resource 
monitor detected at the last interval. Based on this value, the target 
MPL for a domain might be altered. 


This halfword indicates the page delay time Cin milliseconds) that the 
resource monitor detected at the last interval. Based on this value, 
the target MPL for a domain might be altered. 


This halfword indicates the average percent of frames that are fixed or 
used for page I/O. 


This halfword indicates the average percent of frames eligible to be 
fixed that are actually fixed. 


This halfword indicates the count of address spaces (including 
non-swappable address spaces) currently residing in storage. 


This halfword indicates the number of address spaces currently residing 
in storage and marked nonswappable because they are holding ENQ 
resources that other address spaces want. 


This fullword indicates the number of address spaces currently 
logically swapped out because of terminal wait. 


This halfword indicates the number of address spaces currently 
logically Swapped out because of a long or detected wait. 
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Individual User Indicators 


The register conventions generally used by the SRM to process individual user 
functions can help you locate important SRM control blocks. 


Register Contents 
2 ddress of the RMCT 


3 Address of the RRPA 
G Address of the OUCB 
5 Address of the ASCB Cif used by the requested SYSEVENT) 


The SRM user control block (COUCB) contains flags and counters that provide 
information about a specific user. There is one OUCB for each address space, pointed 
to by ASCBOUCB CASCBt+'90!'). 


The following key fields define the characteristics of a specific user: 


OUCBLSW If this bit is set to l, the address space is logically Swapped out. 

OUCBESSW If this bit is set to l, the user has been or will be Swapped to 
extended storage. 

OUCBESSS If this bit is set to l, the user 1s suspended for extended storage 
Swap out. 

OUCBMGSW If this bit is set to l, the user is being or has been migrated to 
auxiliary storage. 

OUCBMNT If this bit is set to 1, the SRM has detected that this user has not 


been dispatched but has been occupying storage for a 
processor-dependent period. The user 1S swapped out until the 
dispatcher informs the SRM that the address space has work to do. 


OUCBAXS If this bit is set to l, the user has been swapped out of storage 
because the user's address space was obtaining auxiliary storage slots 
at the fastest rate in the system when an ASM slot shortage occurred. 


OUCBENQ This bit indicates that a different address space has tried to enqueue 
on a resource held by this address space. This user is treated as 
non-swappable for an installation-defined time period. 


OUCBYFL This field indicates how the address space is created: 


° Bit 1 COUCBSTT) - If set to 1, indicates that a START command 
created the address space. 


e Bit 2 COQUCBLOG) - If set to 1, indicates that a TSO LOGON created 
the address space. 


° Bit 3 COUCBMNT) - If set to 1, indicates that a MOUNT command 
created the address space. 


OUCBCSFS If this bit is set to l, the user is being delayed. Either (1) swap-in 
has failed for this address space because of a shortage of available 
storage, or (2) the user was swapped out because of a shortage of 
pageable frames. 


OUCBFXS This bit indicates that the address space is selected for swap-out to 
relieve a shortage of pageable storage. Either the SRM or the RSM can 
detect a shortage of pageable storage. If OUCBLGFX is set to l1, the SRM 
detected the shortage and the address space had more frames allocated 
to it than did any other swappable address space. If OUCBLGFX is turned 
off, the RSM detected the shortage and the address space had more fixed 
frames than an average address space. 


OUCBDFSW If this bit is set to 1, swap-in has been delayed. The RCEAFCLO and 
RCEAFCOK fields have been increased by the number of frames needed to 
complete the swap-in. 


OUCBJSAS If this bit is set to 1, there was an auxiliary storage shortage at the 


time of job select processing for this user. The user's initiation is 
delayed until the shortage is relieved. 
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If this bit is set to l, there was a pageable frame shortage at the 
time of job select processing for this user. The user's initiation is 
delayed until the shortage is relieved. 


This field contains a code that describes why the user was last swapped 


out. The possible codes and their meanings are: 


01 - Terminal output wait 

02 -—- Terminal input wait 

03 - Long wait 

04 - Auxiliary input wait 

05 - Real storage shortage 

06 - Detected wait 

07 - REQSWAP SYSEVENT issued 

08 -— ENQ exchange by swap analysis 

09 - Exchange based on recommendation values provided by swap analysis 
OA - Unilateral swap-out by swap analysis 
0B - Transition swap 


This bit indicates that ready work became available for this address 
space, which was swapped out because of a wait. The address space, now 
able to execute, is therefore a candidate for swap-in. 


This halfword contains the target working set size for the address 
space. The SRM attempts to keep at least this minimum number of frames 
assigned to the address space. 


This fullword contains the number of outstanding HOLD SYSEVENTs issued 
by the address space. A non zero number results in quiesce processing, 
which turns the swap-out around and restores the address space. 


Other Indicators 


The SRM domain descriptor table can be useful in pinpointing a problem involving the 


SRM's MPL control. Mapping of the table can show causes of erratic response time, 
data about a user kept out of main storage, and other user and system information. 
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SRM SDWA CONTENTS 


When either of the two functional recovery routines (FRRs) is entered (see "SRM 
Recovery Considerations” later in this section), the FRR fills in the SDWA fields 
before scheduling the SVC dump so that the dump matches the SYS1.LOGREC entry. 
However, in some cases, the FRR changes the abend code or reason code after the dump 
is scheduled and before the LOGREC entry is written, which means that the code in 
the LOGREC entry differs from the one in the dump. 


The FRR also places problem determination data into the SDWA variable recording area 
CSDWAVRA) in key-length-data format using standard keys. (See the SDWAVRA area in 
the Debugging Handbook for a description of the keys). The following fields provide 
important information: 


Key Contents 


VRAETF The entry point address of either the SRM routine that was in control at 
the time of the error, or, if a subroutine was in control, the routine 
that called the subroutine. 


VRARRP A copy of the recovery routine parameter area CRRPA). The RRPA contains 
status information used on exit from the SRM and during the SRM recovery 
processing. The low-order byte in the first word of the RRPA contains 
the SYSEVENT code for the original entry to the SRM. The IRARRPA mapping 
macro maps the format of the RRPA. 


VRAFP A copy of the RRPA Cas in field VRARRP) but with several entries cleared 
because they can be different for different invocations of the same 
function. The VRAFP is the footprint area the SRM uses to recognize 
duplicate problems. 


VRALBL The name of the routine that failed. 

VRAOA oe original hexadecimal abend code. The FRR might have changed the 
code. 

VRAAID The address space identifier of the user for which the SRM was invoked. 

VRACA The caller's address if the SYSEVENT was branch-entered. 
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GENERAL INFORMATION USEFUL FOR SRM ANALYSIS 


Information useful to consider when analyzing the SRM for diagnostic purposes 
include its recovery routines and serialization procedures. 


SRM RECOVERY CONSIDERATIONS 


The SRM uses two functional recovery routines (CFRRs) that are located in IRARMERR. 
One FRR Crecovery routine 1, RR1) gets control whenever an error occurs after the 
SRM is branch-entered by a routine that holds a lock higher in the lock hierarchy 
than the SRM lock. The other FRR Crecovery routine 2, RR2) gets control whenever 
errors occur while the SRM is running with the SRM lock. 


If 1t 1s suspected that the SRM is entering error recovery and a stop is necessary 
at the time of error, RMRR2ZINT, a subroutine common to both RR1 and RR2, obtains 
control. 


Recovery routine 1 C(RR1) retries if a retry routine exists. If no retry routine 
exists, or if the error recurs, RR1 percolates the error. 


The specific actions taken for different errors are as follows: 


e If the SRM issues the ABEND macro, or the operation has performed the system 
RESTART function, the error percolates. 


e If the error occurs in the SRM workload activity recording routine, the RMF task 
abends. If the SRM is active in the same address space as the RMF task, the 
error percolates. 


° If a translation or protection exception occurs in SYSEVENT processing, SRM 
recovery changes the abend code to X'15F'. The FRR validates the queue and 
status data that the SRM maintains and percolates the error. 


° For other SRM errors, the FRR validates the queue and status data that the SRM 
maintains and retries the SRM routine that failed. If the error repeats and is 
associated with an action or an algorithm, another retry is attempted to bypass 
the routine in error. Otherwise, the error percolates. 


Recovery routine 2 (RR2) first checks many special situations, such as the 
following: 


e Is RMF active and should it be terminated? 
° Is SET IPS active and should an abend code be converted? 
e Is the OUCB valid and should an abend code be converted? 


RR2 then retries if a retry routine exists. If no retry routine exists, or if the 
error recurs, RR2 percolates the error. The specific actions taken for errors are 
the same as those listed for RR1. 


SRM CIRARMRR1 and IRARMRR2) suppresses dumps by using DAE CDUMP Analysis and 
Elimination). SRM does not suppress dumps that have an error code of X'5F*', because 
they are not necessarily duplicate dumps. SRM uses the default DAE criteria as well 
as the module level Cshown in VRALVL) and the routine name (shown in VRALBL) to 
determine whether a dump is a duplicate. 


The issuing of most SYSEVENTs before SRM NIP processing (performed by IJEAVNIP10) 
causes a direct return of control to the issuer; no SRM processing occurs. 


SRM SERIALIZATION 


All issuers of enabled, branch entry SYSEVENTs must hold the local lock when the 
SYSEVENT is issued. 


The SRM obtains the SRM lock on all SYSEVENT entries except the following: 


USERRDY X'04 
SWOUTCMP X*OF' 
RSMCNSTS X*16° 
AVQLOW X'17' 
AVQOK X*'18' 
SQALOW X'19' 
SQAAOK X*1A' 
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SYQSCST X'23' 
SYQSCCMP X'24' 
HOLD X*32' 
NOHOLD X*'33' 
DIRECTPO X*"38' 
SOUTSUSP X'45! 


The issuer of any of these SYSEVENTs, with the exception of HOLD, NOHOLD, and 
DIRECTPO must be disabled when issuing the SYSEVENT because the SRM uses 
processor-related save areas while processing the SYSEVENTs. The issuer of HOLD, 
NOHOLD and DIRECTPO must also be in Key 0. Because the SRM must be able to obtain 
the SRM lock when it is entered by means of a SYSEVENT, issuers of SYSEVENTsS not 
SerGcNa must not hold the SRM lock or any global lock when they issue the 
SYSEVENT. 
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METHOD OF OPERATION 


This section contains logic diagrams for the modules in this component. 
modules, 


grouped by function, are presented in the following order 


Diagrams 


SRM-1 and SRM-2 
SRM-3 and SRM-6 


SRM-7 


SRM-8 through SRM-13 


SRM~-14 
SRM-18 
SRM-19 
SRM~24 
SRM-27 
SRM~28 
SRM-31 
SRM-34 


through SRM-17 


through SRM-23 
through SRM-26 


and SRM-30 
through SRM-33 
and SRM-35 


Function 


Interface 

Service Routines 

Find Performance Groups 
SRM Control 

Swap Analysis 

Storage Management 

I/0 Management 

Channel Measurement 

CPU Management 

Resource Monitor 
Workload Management 
Workload Activity Recording 


The diagrams use either hipo format or prologue format. 


The 


The following figure shows the symbols used in hipo format logic diagrams. The 
relative size and the order of fields in control block illustrations do not always 
represent the actual size and format of the control block. 
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Primary processing — indicates major functional flow. 


Secondary processing — indicates functional flow within a diagram. 


Data movement, modification, or use. 


Pointer — indicates that a data area contains the address of 
another data area. 


Connector — indicates that a diagram is continued on the next page. 





Figure 9. Key to Hipo Logic Diagrams 
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The prolog format diagrams contain detailed information that is broken down into 
four different headings. The four headings and the topics they document are: 


aoa Description, which includes: 
Descriptive name 


Routines 

Data areas, if any 
_ Control blocks 

e Tables 

e Serialization 


° Function Cof the entire module) 
° Entry point names, which includes: 
a Purpose Cof the entry point) 
= Linkage 
_ Callers 
= Input 
- Output 
= Exit normal 
= Exit error, if any 
e External references, which includes: 


Note: Brief SRM module descriptions are also included in MVS/Extended 


Architecture System Logic Library: Module Descriptions, which contains module 


descriptions for all the MVS/Extended Architecture components described in the 
System Logic Library. 


Module Operation, which includes: 
e Operation, which explains how the module performs its function. 
e Recovery operation, which explains how the module performs any recovery. 


Diagnostic aids, which provide information useful for debugging program 

problems; this includes: 

e Entry point names 

e Messages 

° Abend codes 

° Wait state codes 

e Return codes for each entry point. Within each entry point, return codes 
might be further categorized by exit-normal and exit-error. 


e Entry register contents for each entry point 

e Exit register contents for each entry point 

Logic Diagram, which illustrates the processing of the module, the input it 
uses, the output it produces, and the flow of control. Some modules do not have 

a logic diagram because the processing is sufficiently explained in the module 
description, the module operation, and the diagnostic aids sections. -- Fig 
cpus unknown -- illustrates the graphic symbols and format used in the logic 
lagrams. 
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LOGICKEY - Key to the Logic Diagrams STEP 01 ; 
Callers 
This paragraph describes what this module 
‘\ does. The same text appears under the 
>| | FUNCTION heading on the Module Description 
/ page. 
LOGICKEY 
Numbered steps describe the 
processing at a high level. 
A. Lettered steps describe the processing 
at a lower level. 
SPQA BY ieee Input and output fields. \SPQE 






The control block acronym or data area name 
appears above the input and output boxes; 
and the field names appear within the 
boxes. A dotted arrow means the data is 
referenced, a solid arrow means the data is 
modified. 


SPQE 
SPQENEXT SPQESPQA 
TCB 


External call graphic 
passing the parameter, TROB. 


/L—J\ 
\r—7 ITRFBR 


06, Internal call graphic (Cat 
the step indicated) passing 
two parameters. 


Jed 
\r— SUBROUTN: 12 
EFMSG1,» TFWAPMSG 



















EAECB proc non---- > Macro instruction graphic 
=: \ with these keywords, 
: / parameters, and options. 


ASCB 


POST 


(EAERIMWNT, RCO) ASCB( TOBAASCB->ASCB } 
ERRET(CVTBRET ) 


Internal branch to the label 
and step indicated. 
\ 
>BRLABEL: 08 
/ 






CVT 
CVTBRET 
TOB 


TOBAASCB 


Figure 10 (Part 1 of 2). Key to Prologue Method-of-Operation Diagrams 
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SPQENEXT 
SPQESPQA 
SPQETCB 
SPQEKEY 
SPQESHR 
SPQEOWN 


SPQAFADQ 
SPQALADQ 
SPQAFEDQ 
SPQALEDQ 
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LOGICKEY - Key to the Logic Diagrams STEP 07 


SvC graphic. 


TSOTEST 


\ 

08 > Step 06 branches here. A 
/ program call (PC) graphic 

BRLABEL shows an exit. 


N 









Callers 
N 
a Secondary entry point. 
PARAMETERS 
SECONDEP This paragraph describes the function of 
TROB THISLINE \}| this entry point. Four parameters (to the 
MAXLINES ETPBOPTS /| left) are passed an input. 
TTE DOILABEL 110) This is the beginning of an 
------------ > iterative DO group. 
A. Iterate graphic of the DO 10 
instruction to the specified step 
number. 
. Leave graphic of the DO instruction 
to the specified step number. 11 
External return graphic, to 
the calling routine. | | 
N 7 
AN 
12 > This is an internal 
/ subroutine. 
SUBROUTN 


This paragraph describes the function 
of this subroutine. 






Internal return graphic, to 
a step within this module. 


Figure 10 (Part 2 of 2). Key to Prologue Method-of-Operation Diagrams 
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ITRARMINT MODULE ENTRY POINT SUMMARY 


IGC095 

ITRARMI48 
IRARMIO1 
IRARMI10 


SVC entry point to SRM. 


Branch entry point to SRM. Handle the internal SYSEVENT (30). 


Entry point from IRARMEVT or IRARMCTL. 


Entry point to SRM. Abend a SRM user. 


TRARMGLU MODULE ENTRY POINT SUMMARY 


Fast interface path 24-bit entries: 


ITRARMEOS5 
IRARME50 
ITRARME51 
TRARME53 
TRARME54 
IRARME55 
IRARME60 
IRARME61 
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TIME SYSEVENT 
HOLD SYSEVENT 
NOHOLD SYSEVENT 
TRAXERPT SYSEVENT 
TRAXFRPT SYSEVENT 
TRAXRPT SYSEVENT 
ICSCHK SYSEVENT 
CMDEND SYSEVENT 


Return to the SYSEVENT issuer. 
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DIAGRAM SRM-1. IRARMINT - SRM Interface (1 of 4) 


From 


Input SYSEVENT issuer Process 





IRASECHT 


SYSEVENT — £._______ 
characteristics 


table 


ASCB 


ASCBOUCB 


Time of 





century 


clock From SYSEVENT 


Processor or 
SRM control 
(IRARMCTL) 










Register 0 


Register 15 





SRM Interface 


Verify that the SRM invocation is valid. 


Obtain the SRM lock, if required. 


Establish an error recovery environment. 


Perform the initialization for 
SYSEVENT processing. 


Process the SYSEVENT. 


Trace the SYSEVENT vie GTF 
(generalized trace facility) 


Release the SRM error environment. 


TO SYSEVENT 
Processor 
(IRARMEVT) 


(see 
SYSEVENT 
processor figure) 





Output 


Functional recovery 
routine stack 


SRM FRR 
Address 


RMCTTOD 
ee 


GTF data set 
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DIAGRAM SRM-1. IRARMINT - SRM Interface (2 of 4) 


Extended Description Module Label 
The SRM interface receives control when a SYSEVENT 
macro instruction is issued. If the SRM interface receives 
control by means of a branch entry, IRARMINT or 
IRARMGLU saves the caller’s addressing mode and passes 
control to IRARMI148 in 31-bit addressing mode. Fora 
supervisor call entry, the SVC FLIH saves the caller's 
addressing mode and passes control to IRARMINT in 31Dit 
addressing mode. The SRM interface performs the locking 
necessary to ensure that SRM functions that must be 
serialized are not performed simultaneously on more than 
one processor. SRM requests the SRM lock unconditionally 
before passing control to the SYSEVENT processor. If the 
lock is held by another processor, the lock manager will spin 
waiting for the lock to be released. Otherwise, SRM acquires 
the lock and continues processing immediately. 


IRARMGLU IRARMIOO 


IRARMINT IGCO95 


IRARMGLU IRARMEO5 


Fast interface path 31-bit entries save the caller’s address 
mode and pass control to the corresponding 31-bit entries 
in IRARMEFIP. (See the IRARMFIP diagram). 


1. ‘For all SYSEVENTs that generate supervisor call IRARMINT IGCO95 
entries to the SRM (SVC 95), except for SYSEVENT 

REQSERVC (26), the issuer must be authorized. Programs 

that issue SYSEVENTSs 29 and 2A must have either APF 

authorization or must be assigned the non-swappable pro- 

gram property (PPTNSWP='1') in the program properties 

table. For all other SYSEVENTs, the user is considered, 

authorized only if executing in supervisor state or pro- 

tection keys 0-7, or if authorized by APF (authorized 

program facility). 


For SYSEVENTs that generate a branch entry to SRM, 
the issuer must be executing in protection key 0-7 and 
must be in supervisor state. 


IRARMGLU IRARMI48 


2 TheSYSEVENT characteristics table indicates, for 
each SYSEVENT entry, whether or not the SRM 
lock must be obtained for SRM serialization purposes. 


IRARMINT IRARMOOO 


C 


Extended Description Module Label 


3  IRARMINT establishes a functional recovery routine IRARMINT RMINTOOS 
to protect SRM from unexpected errors. It specifies 

the FULLXM option on the SETFRR macro so that, when 

recovery is necessary, RTM will attempt to restore the 

cross memory environment before invoking SRM's FRR. 

The processing performed for an error situation depends 

upon whether the SRM lock was held. (See Error Process- 

ing.)- 

4 Before passing control to the SYSEVENT processor, IRARMINT IRARMOO1 
IRARMINT obtains a pointer to the SRM user con- 

trol block (OUCB) corresponding to the input ASID 

(address space identifier). For SYSEVENT MEMCREAT, 

there is not yet an OUCB (an OUCB is obtained by 

IRARMEVT if no resource shortages exist). This module 

obtains the current time-of-century and formats it for 

SRM use. The time-of-day clock value is stored and 

shifted 22 bits to the right, and SRM uses the rightmost 

32 bits of the resulting value. Therefore, SRM constants 

representing time are in units of 1024 microseconds 

(approximately 1 millisecond). IRARMINT issues a 75F 

abend if SRM timer pop does not occur in the expected 


interval. 

5 The interface invokes the SYSEVENT processor to IRARMEVT 
initiate the appropriate processing. 

G6 sf GTF is active, the SRM interface produces a GTF IRARMINT 


trace record using the HOOK macro. This record 
includes: 


e Register 0 (as input except that the ASID is placed 
here even when it is not included as input) 


@ Register 1 (as input, with the addition of possible 
return indicators that might overlay input data) 


e Register 15 (containing any necessary return code 
in byte 3) 


J  IRARMINT removes the address of the SRM FRR IRARMINT !tRARMIO1 


from the system FRR stack. 
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DIAGRAM SRM-1. IRARMINT - SRM Interface (3 of 4) 


Input 


Register 6 
Register 5 


Register 4 


Process 


§ Release the SRM lock if it was obtained 
in step 2. 


Q Return the service data if this entry was 
due to SYSEVENT REQSERVC. 


Return to 
SYSEVENT 
issuer 


Output 


Register 1 


User data 
area 
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DIAGRAM SRM-1. IRARMINT - SRM Interface (4 of 4) 


Extended Description Module Label 


8 __siIf the invoking routine did not already hold a lock RMINTO10 
higher in the locking hierarchy than the SRM lock 
(except for SYSEVENTS SYQSCST and SYOSCCMP), 


IRARMINT releases the SRM lock. 


Qs To prevent disabled page faults and an invalid SRM 

invocation, and to insure system integrity, the 
service data is stored while not holding the SRM lock, and 
in the user’s protection key. 


If the SRM interface received control by means of a branch 
entry, IRARMINT restores the caller’s addressing mode and 
returns control. 


Error Processing 
The issuer of aSYSEVENT is abnormally terminated 
(ABEND code ‘15F'X) if: 


@ An invalid ASID or SYSEVENT code was supplied 
(reason code 4). 


IRARMINT 


@ The program was not authorized to issue the 
SYSEVENT (reason code 8). 


@ A page fault occurred in referencing a data area 
assumed to be fixed (reason code 12). 


@ The program did not have the correct storage key for 
storing into a parameter data area (reason code 16). 


@ The SRM lock was held on entry to the SRM (reason 
code 20). 


A SYSEVENT issuer is terminated (ABEND code 
‘25F’) if SRM determines that a system failure has 
resulted in the loss of data used by the SRM in control- 
ling an address space. Similarly, the set IPS task will be 
terminated (ABEND code ’25F‘) when SRM receives an 
error occurring during SRM processing relating to a set 
to new IPS command. 


C C 


Extended Description Module Label 


A functional recovery routine (FRR) provides the error IRARMERR 
recovery environment for SRM processing. When an error 
occurs during SRM processing (or when an error occurring in 
a routine invoked by SRM has been passed back (perco- 
lated) to SRM), the recovery/termination manager estab- 
lishes the cross memory environment that existed at the 
time the SRM FRR was created and gives control to the 
SRM FRR. If SRM was operating without holding the 
SRM lock when the error occurred, error processing will 
consist of making one attempt at retrying the failing 
routine; a second failure will result in the error being 
passed to the previous routine in the FRR stack. If SRM 
was operating under the SRM lock when the error 
occurred, the FRR will perform queue validation before 
making an attempt at retrying the failing routine; queue 
validation consists of verifying that the three OUCB 
Queues are properly chained (re-chaining where necessary), 
and that OUCBs OUXBs (user control block extensions), 
and OUSBs (user swappable blocks) exist and are valid, 
where they are required. Likewise, the pointers between 
the ASCBs and OUCBs is checked. Where it is necessary 
to create a new OUCB or OUXEB, a bit is set in the OUCB 
to indicate that the data reflected in these newly created 
blocks may not be valid. 


IRARMRR1 


IRARMRR2 


RMRRA2VLD 


When errors occur during SRM locked processing, retry 
action depends upon whether the error occurred during 
SYSEVENT related or non-SYSEVENT related process- 
ing. For SYSEVENT -+elated processing, one retry will be 
attempted. Subsequent failure will result in the error 
being passed to the previous routine in the FRR stack. 
For non-SYSEVENT-related processing (that is, process- 
ing which SRM control was driving), one retry of the 
failing routine will be attempted. A second error will cause 
an attempt to bypass the twice failing routine. Subsequent 
errors will result in the error being passed to the previous 
routine in the FRR stack. 
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DIAGRAM SRM-2. IRARMFIP - SRM Fast Interface (1 of 2) 


Input 


RMCTTSAC 


RMCTRTAC 


T 


CP 


TCPUN KWN 


OUCB 


OUCBHOLD 





TIME sysevent 
from IRARMGLU 










HOLD 
sysevent from 
IRARMGLU 






HOLD 
sysevent from 
IRARMGLU 


Process 
Entry point: IRARMFO5 
1 Obtain necessary locks. 
2 Update channel measurements. 


3 > Invoke the time-slice and rotate 
algorithms. 


4 Check TOD clock status and 
sample the channel path status 
and the UCB queue length. 


5 Reset the SRM timer. 


G Schedule any other due 
algorithms. 


Entry Point: IRARMF50 


7 increase a user’s hold count by 
one. 


Entry Point: IRARMF51 


8 Decrease a user’s hold count by 
one. 








IRARMCTL 
or issuer 


Issuer 


Output 











RMCT 


RMCTPLR 





OUCBHOLD 
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DIAGRAM SRM-2. IRARMFIP - SRM Fast Interface (2 of 2) 


Extended Description Module Label 

The SRM fast interface path receives control when special 

pre-defined SYSEVENTs are issued. This path does not 

validity check the issuer, nor does it perform the normal 

generalized entry processing. 

1 For the TIME SYSEVENT, obtain the SRM lock and IRARMFIP IRARMFOES& 
establish an FRR. IRARMFIP IRARMRT‘4 

IRARMFIP IRARMTS1 
2 IEAVEACO 


e If the hardware supports the collection of processor 
controller data and it has been dropped, IRARMFIP 
updates the channel measurements. If none have been 
dropped for 10 minutes, fast interface path tries to restart 
the facility. 


e If the processor controller data is not provided and 
sampling is due, [RARME IP gets data from channel path 
status and UCB queue lengths. 


3 If time slicing control is active and the algorithms 
are due, |RARMEF IP invokes them and then per- 
forms any priority changes required. 


4 If the TOD clock is invalid, IRARMF IP calls 

IRARMMSP to stop channel measurements. If the TOD 
clock is valid and channel measurements are not active, mark 
channel measurements as pending start. If sampling is due, 
invoke IRARMCPS and IRARMDBS to measure the current 
channel path activity and the SSCH queue Jength for the 
UCBs. 


IRARMFIP IRARMCPS 
IRARMFIP IRARMDOBS 


5 Queue a TOE for the minimum of 1 SRM second or 
the time when either a channel measurement sample 
or the time slice algorithm is due to execute again. 


IRARMSRV IRARMIO5 


6 If other SRM algorithms are due, turn on the 
corresponding bits in RMCTALR and exit to the SRM 

control routine. If no other algorithms are due, return 

to the invoker through the SRM standard interface. 


IRARMCTL 


IRARMINT IRARMIO1 


c 


‘a 


Extended Description Module Label 
7 =For the HOLD SYSEVENT, increase a full word 
counter in the OQUCB via compare and swap. Return 


to the issuer. 


IRARMFIP IRARMF50 


8  Forthe NOHOLD SYSEVENT, decrease the count of 
outstanding hold events for a user and return. 


IRARMFIP IRARMF51 


Error Processing 


The TIME SYSEVENT establishes an FRR to process 
errors that occur in the processing of the SYSEVENT. 
The recovery routine performs queue verification and 
then attempts retry. The retry routine sets a new timer 
value and exits through the standard SRM interface. 


IRARMERR IRARMRR2 


RMRR2VLD 
IRARMFIP IRARMXIP 
IRARMINT IRARMIO1 


The remaining SYSEVENTs in this module do not establish 
recovery environments. 


Entry Point Summary 


IRARMEIP module — interface routines — entry point summary 


IRARMFOS — Invoke time slice algorithm: reset SRM’‘s 
timer; schedule other algorithms due. 


IRARMTS1 — Time-slicing algorithm. 

IRARMCPS — Channel path sampling routine. 
1RARMDBS — UCB queue length sampling routine. 
IRARMXIP — Retry routine for fast SYSEVENTSs. 
IRARMF50 — Increase a user’s HOLD count. 
IRARMF51 — Decrease a user’s HOLD count. 
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TRARMSRV MODULE ENTRY POINT SUMMARY 


IRARMIO2 
TRARMIOS 
TRARMI04 
IRARMIO5 
IRARMI06 
ITRARMIO7 
IRARMIO08 
IRARMIO9 
IRARMI11 
IRARMI16 
IRARMI17 
IRARMI20 
IRARMI21 
TRARMSFT 


ASCBCHAP entry point. 

UIC steal processing entry point. 
Obtain or free SQA or ESQA storage. 
Requeue SRM TQE routine. 

Cross-memory post entry point. 

Swap SRB schedule routine. 

I/0 enablement SRB schedule routine. 
RECORD entry point. 

ENF signal entry point. 

Cross-memory post routine. 

Post ECB while holding the local lock. 
Fixed frame count routine. 

Obtain or free double frame pair routine. 


Invoke safety net check. 


TRARMERR MODULE ENTRY POINT SUMMARY 


IRARMRR1 


TRARMRR2 


RMRR2RTY 
RMRR2PER 
RMRR2INT 
RMRR2VLD 
RMRR2GST 
RMRR2CKQ 
RMRR1IVFB 
RMRR2ZREQ 
RMRR2SPR 


LY28-1760-0 


Functional recovery for globally locked entries Centries to SRM in 
which the SRM lock could not be obtained). Retry the failing SRM 
routine when possible, otherwise percolate the error. 

Functional recovery for non-global locked entries Centries to SRM in 
which the SRM lock was obtained). Validate queue and cleanup. Copy 
error-related data into the fixed and variable parts of the SWDA. Issue 
an SDUMP and record the log record. Retry the failing routine if 
possible; otherwise, percolate the error. If the failing routine was an 
action or algorithm routine and retry has been attempted once, bypass 
the failing routine and retry the control routine algorithm twice if 
necessary, before percolation. 

Return to RIM indicating retry. 

Return to RTM indicating percolation. 

FRR initialization. 

Validate the control blocks. 

Release the dispatcher lock in order to call IRARMIO4G. 

Verify the location of an OUCB. 

Verify addresses. 

OUCB enqueue routine entry point. 


Return with the return code in register 15. 
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DIAGRAM SRM-3. IRARMSRYV - SRM Service Routine (1 of 14) 
From IRARMCPM, 
IRARMCTL or IRARMEVT 


Input Process 


Register 1 


List of ASCBs 


Invoke ASCBCHAP to reorder 
the listed ASCBs on the dis- 
patching queue. 


—~_= YJ 


From storage management 
(IRARMSTM) 





Register 1 






Parameter List IRARMIO3 


Call UIC steal processing. 






Steal criteria 






Number of 
frames to steal 






RW 
2 


Register O 


Total number of 


frames to steal 
from all ASCB’s 












Output 





Dispatching queue 
IEAVEACO 


ASCBCHAP 


Return to caller (IRARMCPM, 
IRARMCTL, or IRARMEVT) 


Register 1 


IARXSF 


UIC steal 


Parameter List 

4 ASCB 

Flags 

User’s high UIC 


processing 





Number of frames 
to steal 


Return to 
storage 
management 
(IRARMSTM) . 
Register 0 
Total number 
of frames 
stolen 
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DIAGRAM SRM-3. IRARMSRV - SRM Service Routine (2 of 14) 


Extended Description Module 


This module is a collection of several independent routines IRARMSRV 
that act as interfaces between SAM and various system 
services. 


IRARM!02 IRARMSRV 
Reposition the listed ASCBs in the ASCB dispatching IEAVEACO 
queue to reflect their new dispatching priorities. 


IRARMIO3 IRARMSRV 
Steal pages from users included in the list that have frames | aRXSF 


with UICs that meet the steal criterion. 


Cc 


Label 
(or Segment) 


IRARMSRV 
IRARMIO2 


IRARMIO3 
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DIAGRAM SRM-3. IRARMSRV - SRM Service Routine (3 of 14) 


From SRM 
routines 


Input 


Process 













Register 1 


CELLSIZE a 
Register 0 | 


IRARMIO4 
Obtain or free storage in the SQA 
or ESOA. 


Return to 
caller 


From periodic entry 
Point scheduler (IRARMFO5 and IRARMCET) 


Register 1 
Timer value (SS —_ Update the SRM TOE and queue 


IRARMIO5 


it on the system timer queue. 





Return to 
caller 
(IRARMFOS) 
















or 






FREECELL 


r 


or 


GETMAIN/ 
FREEMAIN 


iEAQTEOO 


ENQ TQE 
routine 


L 













Register 1 


Return code 


[| 


TQE 
air 


TQEVAL 
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DIAGRAM SRM-3. IRARMSRV - SRM Service Routine (4 of 14) 


Extended Description 


IRARMIO4 
Obtain or free SQA or ESQOA storage either from 
a cell in SRM’s cellpool or ‘rom other aveilable 
SQA or ESQOA. 


IRARMIOS 
Store a new timer value in the SRM TQE and queue 
the TQE on the system timer queue. 


Label 
Module (or Segment) 


IRARMSRV IRARMIO4 
IGVCPBDB or 
IGVCPGUB or 
IGVCPFRE 

IGVVSM31 


IRARMSRV IRARMIO6 
IEAVRATIO IEAQTDOO 
IEAVATIO IEAQTEOO 
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DIAGRAM SRM-3. IRARMSRV - SRM Service Routine (5 of 14) 


input 


From SRM 
routine 


Process 









Register 0 


Register 1 

— 
Register 5 

| \ asce | 


From control 
swap-in (IRARMCSI) 














1EAOPTO1 


Cross 
memory post 


IRARMIO6 
Post an ECB in another memory. 









Return to caller 












Register 5 


MCT 
MCCPHCRI 


\EAVESC1 


SRB 
schedule 


IRARMIO7 
Schedule an SRB to initiate a 
swap-in. 





Return to caller 


Output 


Return code 
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DIAGRAM SRM-3. IRARMSRV - SRM Service Routine (6 of 14) 
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Label 

Extended Description Module (or Segment) 
IRARMIO6 IRARMSRV IRARMIO6 

The swap-out routine (IRARMCSO) uses this entry 

point to post the region control task. The entry 

point is also used by SYSEVENTs OF (SWOUTCMP), 

OC (QSECST), and OD (QSCECMP) to post an address 

space that issued a TRANSWAP or REQSWAP 

SYSEVENT. If an error is encountered during the IEAVSY50 !EAOPTO1 

cross memory post, the error routine (IRARMXPE) IRARMSRV IRARMXPE 


receives control in 31-bit addressing mode. If the 
swap-out routine invoked IRARMIO6, |IRARMXPE 
sets up an FRR, and attempts to clean up. If the 
swap-out routine did not invoke IRARMIOG, 
IRARMSRV issues an abend with completion code 
X‘55’. Processing this abend results in an SDUMP 
and termination of the waiting address space. 


IRARMSRV IRARMIO7 
{EAVESPM IEAVSPM1 


IRARMIO7 IAVSESCO IEAVESC1 


The swap-in routine (IRARMCSI) uses this.entry point 
to obtain and schedule RSM routines in the master 
scheduler’s address space. For a suspended swap-out 
redrive, it schedules RSM routine |ARSURST. Fora 
swap-in or migration swap, it schedules RSM routine 
[ARSIN. To enable the RSM to determine if swapping 
the user in might cause a pageable frame shortage, 
IRARMIQ7 also passes the shortage threshold 
(MCCPHCRI) to RSM in the SRB. 
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DIAGRAM SRM-3. IRARMSRV - SRM Service Routine (7 of 14) 
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1EAVESC1 


SRB 
Schedule 


Register 1 











Schedule an SRB 
with CPU affinity 

to update the 

1/0 enablement mask 
in register 6. 


‘ CPU affinity 
mask 








Return 
to caller 









From storage 
management (IRARMSTM) 











Register 1 


IEAVTRER 








IRARMIOS 
invoke the record facility to issue a 
WTO to the system operator. 


t List form of 


WTO message 








Return to caller 


Output 
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DIAGRAM SRM-3. IRARMSRV - SRM Service Routine (8 of 14) 


Extended Description 


IRARMIOS 
Schedule an SRB with CPt! affinity 
to cause 10S to change the i/O 
enablement mask in control 
register 6. 10S uses the information 
found in the PCCA. 


{(RARMIO9 
Invoke the RECORD facility to issue a WTO to 
the system operator console, because the requesting 
SRM routine holds the SHM lock and cannot 
issue a WTO. 


Module Label 


IRARMSRV IRARMIOS 


lOSRISCE IOSRISCE 


IRARMSRV IRARMIOS 


IEAVTRER IEAVTRER 
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DIAGRAM SRM-3. IRARMSRV - SRM Service Routine (9 of 14) 
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Completion code 
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Completion code 
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(IRARM 
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IRARMI16 
(via SRB 
schedule) 


Process 





Output 


IRARMI1I1 
Register 15 
Return code 


Signal an ENF event. 






Return to 
caller 


IRARMI16 


DATAPARM 
Build and schedule a global 


non-quiescable SRB to IRARMI17. Completion code 


A ece 


IEAVESC1 


SRB 
schedule 







A asce 
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DIAGRAM SRM-3. IRARMSRV - SRM Service Routine (10 of 14) 


Extended Description 


IRARMI11 
This entry point is an interface to ENF (event 
notification facility) to signal an event. IRARMI11 
issues the signal based on the ENF code passed to 
IRARMI11 in register 15. The return code from ENF 
is passed through to the caller of IRARMI11 in 
register 15. 


IRARMI16 
Swap-in or swap-out control uses this entry point to 
post the quiesce ECB. The routine accomplished a 
cross-memory post by , ‘eposting the ECB, if no wait 
or post has been done, or by scheduling an SRB to run 
in the address space to be swapped in. The SRB entry 
point is IRARMI17, 
The SRB and the data area containing the post 
parameters are built in an unused area of the 
OUXB (OUXBFLDS). 


iRARMI17 
This entry point receives control under an SRB 
scheduled by IRARMI16. The routine calls 
POST to post the indicated ECB and then restores 
the OUXB fields. 


Module 


IRARMSRV 


IEFENFFX 


IRARMSRV 


IEAVESCO 


IRARMSRV 


IRARMSRV 


lEAVSY50 


Label 


IRARMI11 


IEFENFFX 


IRARMI16 


lEAVESC1 


IRARMI17 


IRARMI17 


lEAOPTO2 
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DIAGRAM SRM-3. IRARMSRV - SRM Service Routine (11 of 14) 
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Output 










invoke RSM to IARXCNTF 
count the number 
of fixed frames. Count of 
fixed frames 
Register 1 {RARMI21 {ARUBGTS Register 1 
Number of peirs invoke RSM to Double frame [ 
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peirs. IARUBFRS | 


Double frame 
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DIAGRAM SRN-3. IRARMSRV - SRM Service Routine (12 of 14) 


Extended Description 


IRARMI20 
invoke RSM to obtain the fixed frame count for an 
address space or the common storage srea (CSA). 


IRARMI21 
Invoke RSM to manage the double frame queue 
that segment table allocation uses. Set register 1 
to a negative number if the call requests that the RSM 
free frames. Set register 1 to a positive number if the 
call requests that the RSM obtain frames. 


Module Label 


IRARMSARV IRARMI20 
IARXC IARXCNTF 


IRARMSRV IRARMIZ21 
(ARUB (ARUBFRS 
\ARUBGTS 


uNGI JO STCFUSQEH POOF 1WQSEYu,, 


WaI 30 AjQuedoud — STT1838N PESUeST 


0-O9ZT-S2A1 +UBW Sey SAS ?11S VX/SAW 46-WUS 


*duod WAI PYBT4AdOD (9) 


Z86T 


DIAGRAM SRM-3. IRARMSRV - SRM Service Routine (13 0f 14) 
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DIAGRAM SRM-3. IRARMSRV - SRM Service Routine (14 of 14) 


Extended Description 
JIRARMI30 


Once started, the service processor collects data and period- 
ically updates the SADB with the data. SRM obatins the 


Once started, the service processor collects data and period- 
ically updates the SADB with the data. SRM obtains the 
control block, SADB. 


Module Label 


IRARMSRV IRARMI30 
IRARMSRV 


IRARMSRV IRARMI30 
IEAVMSF IEAVMSF1 
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DIAGRAM SRM-4. IRARMSFT - Invoke Safety Net Check (1 of 2) 


From CPUTLCK 
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Input | Process 
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Address of IRARMSFT 
ASCH tobe. [—__ 


checked. 











Return to caller 
CPUTLCK in IRARMCPM 


IEAVEMSS 


Safety Net Check 
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ready ASCB to 
the dispatching 
queue. 
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DIAGRAM SRM-4. IRARMSFT - Invoke Safety Net Check (2 of 2) 


Extended Description Module Label 


The CPUTLCK subroutine in IRARMCPM determines 
that either: 


@ A ready address space is not on the dispatching 
queue or 


® a processor is not fully utilized which may indicate 
that the dispatcher cannot locate the ready address 
space. 


The CPUTLCK subroutine invokes |EAVEMSS, entry 
point in IRARMSFT. IEAVEMSS locates and adds 
the ready address space to the dispatching queue. 


Control returns to the CPUTLCK subroutine. 
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IRARMEVT MODULE ENTRY POINT SUMMARY 


TRARMRVT 
TRARMXVT 


TRARMDEL 
IRARMAPG 


TRARMSWI 


IRARMLDB 
TRARMUXB 


LY28-1760-0 


SYSEVENT processor. Begin to process the indicated SYSEVENT. 


SYSEVENT retry. Prepare a retry of SYSEVENT that incurred a system 
error. 


Synchronize memory delete processing. 


Check the automatic priority group (APG) status and reposition the user 
on the ASCB dispatching queue. 


Place the OUCB of the newly swapped-in user on the IN queue and preform 
related processing. 


Create or free device-related control blocks for I/0 load balancing. 


Synchronize OUXB deletion at swap-out completion time. 
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IRARMFPG MODULE ENTRY POINT SUMMARY 
IRARMFPG finds the performance group to associate with a unit of work. ) 


DIAGRAM SRM-5. IRARMFPG - Find Performance Groups (1 of 7) 


FUNCTION: 

This routine is called whenever SRM needs to determine the 
proper performance groups to associate with a unit of work. 
The unit of work may be a batch jobstep», a TSO user, TSO 
command, started task, or a transaction from the transaction 
report SYSEVENTs. IRARMFPG determines the proper performance 
groups according to the Installation Control Specification 
(ICS) PARMLIB member currently in effect. The subsystem, 
userid, transaction name, transaction class, and account 
number associated with the unit of work are supplied by 

the caller as input parameters. 


ENTRY POINT: IRARMFPG 


PURPOSE: See function 


LINKAGE : 
REG 0 - address of output area FPGO 
REG 1 - ICSP ICS input parameter list 
REG 2 - RMCT address 
REG 3 - RRPA address (recovery parameters ) 
REG 4 - OQUCB address of memory with which to 
associate the SYSEVENT 
REG 5 - ASCB address of memory with which to 


associate the SYSEVENT 
REG 6 : REG 12 - irrelevant 
REG 13 - address of current stack frame 
REG 14 : REG 15 - irrelevant 


CALLERS: ) 
- IRARMEOS - JOBSELCT SYSEVENT PROCESSOR EVT 
- IRARME1O - INITATT SYSEVENT PROCESSOR EVT 
- IRARME27 - EASINIT SYSEVENT PROCESSOR EVT 
- IRARME63 - CMDSTART SYSEVENT PROCESSOR EVT 
- IRARMNM8S - TRANSACTION REPORTING ALGORITHM WLS 
- IRARMSIC - "SET ICS” ROUTINE SET 
INPUT: 


- Register 1 points to either 

1) The parameter list (ICSP) which contains subsystem 
name, transaction name, USERID, transaction class, and 
(optionally) flags» a performance group number, and an 
account number. OR 

2) A shorter parameter list identical to the first four 
fields of the ICSP, but not containing the flag; 
optional performance group, or the account number. 
This short list is used by transaction reporting to 
obtain RPGNs only. (Callers IRARMWM8 and IRARME63. ) 

If a complete ICSP is present, the high order bit of 
register 1 is turned on. This also shows that a 
control performance group and a report performance 
group is requested. 


- Register 0 points to the area mapped by the FPGO which 
will contain the CPGN and RPGNs. The caller must 
clear the RPGN fields prior to calling FPG if checking 
for valid data is desired on return. 


- Tables pointed to by RMCTICST->ISCC->ICSS-ICSE 
- OUCBACNT indicates account number on JOB statement 
OUTPUT : 
- Register 15 contains the return code. ) 


- The output area (pointed to by register 0 on input) 
contains the performance groups found by FPG, if any. 
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DIAGRAM SRM-S5. IRARMFPG - Find Performance Groups (2 of 7) 


IRARMFPG - MODULE DESCRIPTION (Continued) 


The return code tells which have been found. 
EXIT NORMAL: 
EXIT ERROR: No error exits 
EXTERNAL REFERENCES: 
ROUTINES: None 


CONTROL BLOCKS: 
ICSP - Installation Control Specification Parameters 


Icsc - Installation Control Specification Common 
ICSS - Installation Control Specification Subsystem 
ICSE - Installation Control Specification Entry 
OUCB - SRM User Control Block, one per address space 
RMCT - SRM Control Table, anchor for all SRM 


SERIALIZATION: SRM LOCK 
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DIAGRAM SRM-S. [RARMEFPG - Find Performance Groups (3 of 7) : 
IRARMFPG - MODULE OPERATION 


This routine scans the tables that describe the 
Installation Control Specification (ICS), looking for a 
match on the subsystem name in the input parameters. 
Finding this, if Report Performance Groups Numbers 

(RPGN) were 

requested, FPG looks for a match on the transaction 
names, userids, transaction classes, and account number 
for that subsystem and assigns a report performance group 
from the tables for every match found. If a Control 
Performance Group Number (CPGN) was requested, the CPGN 
corresponding to the highest matching level name is used. 
If no match is found on the transaction name, account 
number, userid or class» a subsystem default CPGN is 
always assigned. RPGN fields are neither set to zero nor 
defaulted if no specific match is found. 


RECOVERY OPERATION: IRARMFPG participates in component wide recovery. 


SRM-102 MVS/XA SLL: Sys Res Mgmt LY28-1760-0 (Cc) Copyright IBM Corp. 1987 


"Restricted Materials of IBM" 
Licensed Materials —- Property of IBM 


DIAGRAM SRM-S, IRARMEPG - Find Performance Groups (4 of 7) 


IRARMFPG - DIAGNOSTIC AIDS 


ENTRY POINT NAME: IRARMFPG 


MESSAGES: None 


ABEND CODES: None 


WAIT STATE CODES: None 


RETURN CODES: 


- Q SUBSYSTEM MATCH FOUND. 

REQUESTED PGNS RETURNED. 

SUBSYSTEM MATCH FOUND. 

NO REPORT PERFORMANCE GROUPS FOUND. 
SUBSYSTEM MATCH NOT FOUND. 


o Ff 


REGISTER CONTENTS ON ENTRY: Irrelevant 


REGISTER CONTENTS ON EXIT: frrelevant 
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DIAGRAM SRM-S. IRARMFPG - Find Performance Groups (5 of 7) 
IRARMFPG - Find Performance Group Subroutine STEP 01 


~ IRARMEO8 - JOBSELCT SYSEVENT This routine is called whenever SRM needs 


PROCESSOR EVT to determine the proper performance groups 
- IRARME1O - INITATT SYSEVENT to associate with a unit of work. The unit 
PROCESSOR EVT of work may be a batch jobstep, a TSO 
- IRARME27 - EASINIT SYSEVENT user, TSO command, started task, or a 
PROCESSOR EVT transaction from the transaction report 
- IRARME63 - CMDSTART SYSEVENT SYSEVENTs. IRARMFPG determines the proper 
PROCESSOR EVT performance groups according to the 
- IRARMAM8& - TRANSACTION Installation Control Specification (ICS) 
REPORTING ALGORITHM WLS PARMLIB member currently in effect. The 
- IRARMSIC - "SET ICS" ROUTINE subsystem, userid, transaction name, 
SET transaction class, and account number 

N associated with the unit of work are 

>| |supplied by the caller as input 


parameters. 


/ 
ITRARMFPG 








Scans the tables that \ 
ICSCEND ICSPSUBO describe the Installation /|rcsserr | 
ICSSNAME ICSSSUBS Control Specification (ICS) 
ZERO looking for a match on the 

subsystem name in the input 

parameters. 


~----------- > If no subsystem match is \ 
ICSPSUBO ICSSNAME \ found, set return code. 71 RTNCOD 
/ FLAGS 


RCNOSYBS RCNORPGN 





Sf sores aa > Depending on caller's 


INPREG ICSPACTL request and the current 
OUCBACNT ICSSACTN environment, sets flags RPGNUSRD 
indicating which control RPGNCLS 
and/or report performance FPGOCPGN 
groups are needed. 


RPGNACTN 


------------ > Set the subsystem RPGN if \ 
\ there is one. / | FPGOSRPG 
/ RTNCOD 








ICSSRPGN RCSUCCES Searches each table until 
the requested PGNS are 
found. When a report 
performance group is found, 
resets the RPGN flag. When a 
control performance group is 
found, reset all CPGN flags, 
thus terminating the search 
of all remaining tables for 
a CPGN. 


A. Obtains performance group numbers from 
the transaction name table. 


su 
\r—Z7 FINDTRXN 
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DIAGRAM SRM-S. IRARMFPG - Find Performance Groups (6 of 7) 


IRARMFPG - Find Performance Group Subroutine STEP O58 


B. Obtains performance group numbers from 
the userid table. 
vy 
\ro17 


oO 


. obtains performance group numbers from 
the transaction class table. 
sy 
\r-—V FINDCLS 


a a cats >| D. If account number CPGN or RPGN is 


CPGNACTN RPGNACTN needed, obtains performance group 
numbers from the account table. 





fu 
\r—7 FINDACTN 
2----------- > 06, If a control performance \ 
CPGN FPGOCPGN \ group was requested, but not /|FPGOCPG 





4 


/ yet filled in, sets a CPGN. PGNPTR 
If a CPGN was included in 
the input parameters and it 
matches an optional CPGN 
from the ICS, then sets the 
CPGN with the input 
parameter. Otherwise, uses 
the subsystem default CPGN. 


ICSSOPG ZERO 
ICSSXPGN OPGN 







ICSPPGN ICSSPGN 


IRACTLEP 
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DIAGRAM SRM-5. IRARMFPG - Find Performance Groups (7 of 7) 


[RARMFPG| Find Performance Group Subroutine 


FINDTRXN 





FINDUSRD 








FINDCLS 


0005 FINDACTN 
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ITRARMCTL MODULE ENTRY POINT SUMMARY 


TRARMASM 


ITRARMCTL 


TRARMCEN 


TRARMCEL 


TRARMCET 


TRARMCED 


TRARMCQT 


TRARMCRD 


IRARMCRL 


TRARMCRN 


TRARMCRT 


IRARMCRY 


ITRARMCSF 


TRARMCSI 


TRARMCSO 


TRARMRPS 


LY28-1760-0 


Auxiliary stage shortage monitoring. Monitors the extent of auxiliary 
storage allocation. Informs the operator if there is a shortage of 
available auxiliary pages and directs the swap out of users currently 
acquiring slots at the faster rate. 


Mainline control processing. Transfers to deferred user action 
Pre cace ns CIRARMCEN) and then to the algorithm request routine 
CIRA : 


Deferred user action processing. Examines the OUCBACN field of the OUCB 
to determine the users on the action queue and routes control to all 
routines whose request bits have been set in the OUCBACN field. 
Dequeues each OUCB after its indicated actions have been performed. 


Algorithm request routine. Examines the RMCTALR and RMCTALA fields in 
the RMCT and routes control (via IRARMCRT) to each algorithm whose 
request bit has been set in either of the two fields. Resets the 
individual bit after each algorithm completes. 


Periodic entry point scheduler. A timer initialization, schedules the 
algorithm currently due for execution and queues the SRM timer element 
to permit interrupts when the next algorithm is due for execution. 


SRB dispatched original entry processor. Receives control under an SRB 
scheduled by the dispatcher and sets up an entry to the mainline of SRM 
CIRARMCEN) by issuing SYSEVENTC30). 


Periodically invoked entry point rescheduler. Accepts a request to 
reschedule the execution of a periodically invoked algorithm and 
requeues the corresponding RMEP block on the timed entry queue. 


SRB scheduling routine. Accepts a request to schedule the SRM SRB, 
which if available, is scheduled to obtain the SRM lock. 


Algorithm scheduling routine. Accepts requests for an algorithm to be 
ale aae= on the bit associated with the algorithm in the RMCTALA or 


Action request routine. Accepts requests for an action which must run 
under the SRM epee If the SRM lock is held, control passes immediately 
to the action via routing routine. If the SRM lock is not held, the 
bit set in the OUCBACN field of the OUCB associated with the requesting 
user identifies that the action requested is deferred. 


Entry point table scanner. Accepts an invocation bit pattern and an 
entry point table address. Compares the bit pattern to invocation flags 
in the entry point table entries. Invokes the routine identified by the 
entry point when a match is found between the bit pattern and the 
invocation flags. 


User swap request receiving routine. Accepts a request for a user swap 
and checks to see if such a swap is already in progress. Routes 
control to IRARMSCO or IRARMCSI if a swap is not in progress and the 
SRM lock is held. 


Deferred swap analysis. Scans the WAIT queue for the deferred users who 
could not be swapped in because of a storage shortage If a swap-in 
appears possible, the user is taken out of the deferred state and 
Placed on the OUT queue to be considered by swap analysis. 


User swap-in request. Accepts a swap-in request, allocates an OUXB for 
the user and initiates the swap-in 


User swap-out request. Accepts a swap-out request and posts the region 
control task's quiesce routine to initiate the swap-out. 


OUCB repositioning routine. Dequeues an OUCB and requests it on the 
queue specified by its user indicators. 
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DIAGRAM SRM-6. IRARMCTL - SRM Control (1 of 2) 


Input 





Register O 








Address of SRB 


From SYSEVENT 
processor 
(IRARMEVT) 


Process 














2 
From SYSEVENT 
processor when 
SYSEVENT TIME(05) 
is received. 

3 
From dispatcher 
(1EAVEDSO) 

4 


Process all actions that have been deferred 
and can now be performed. 
(See Diagram SRM°8.) 


Route control to all algorithms that were 


previously requested, and can now be performed. 


(See Diagram SRM-9.) 


Request the invocation of time -driven 
algorithms. 
(See Diagram SRM-10.) 


issue SYSEVENT 30 to perform control 
mainline processing (steps 1 and 2). 





To 
IRARMINT 
return point 
(IRARMIO1) 


Step 1 


To 
IRARMINT 
entry point 
(IRARMI48) 


Control 
mainline 
processing 
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DIAGRAM SRM-6. IRARMCTL - SRM Control (2 of 2) 


Extended Description 


SRM Control routes control to actions and algorithms 
that have been requested and also to timed algorithms 
that have come due. 


1. Route control to actior.: that have been requested 
but deferred. Actions are SRM functions performed 
on behalf of a single user. 


2 Route control to algorithms that have been 
requested. Algorithms are SRM functions performed 
on behalf of the system. 


3 Request the invocation of time-driven algorithms 

that are now due. The queue of time-driven 
algorithms is scanned, and all algorithms that are due are 
requested by turning on representative bits in RMCTLAR. 
SRM Control now branches to step 1. Continuing with 
step 2, SRM Control will route control to those time- 
driven algorithms that were . squested. 


4 = This SRM Control entry point receives control under 

an SRB scheduled by another SRM component. The 
SRB was scheduled on behalf of routines not holding the 
SRM lock to execute critical actions and algoithms. Upon 
receiving control under the SRB, SRM Control makes a 
branch entry into the interface module, IRARMINT, to 
execute SYSEVENT 30. Th> SYSEVENT processor will 
in turn branch to SRM Control at step 1. Contro! will 
then be routed to the critical actions and algorithms that 
were requested. 


Module Label 


IRARMCTL 


IRARMCTL IRARMCEN 


IRARMCTL IRARMCEL 


IRARMCTL IRARMCET 


IRARMCTL IRARMCED 
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DIAGRAM SRM-7. IRARMCEN - Deferred Action Processor (1 of 2) 


Sequential flow in 
SRM control 
(IRARMCTL) 
Input Process Output 





RMCT 
Sa ee 
RMCTAQHD 









Deferred Action Processor (IRARMCEN) 









IRARMFIP 









1 if SRM timer is off the system 
timer queue, simulate a timer pop. 



















2 Verify that more users remain on the 
deferred action queue. 
















Continue SRM 
control mainline 
Processing 


No OUCBs Remaining 


























PE 3 R . Shortened 
emove the next OUCB from the dateciea 
f 
waa bebe ; deferred action queue. achat 
as 


queue queue 







Route control to the action routines 
requested for this user. 


RMCTEPOT 


War JO Ajzuadoud — STeTua,eW pasussty 


uWNdGI JO STCTHBQEW P2zZITIURASSY,, 





0-O09ZT-82Al 


‘duod WAI #YBTYAdOD (2) 


L86T 


uoT}Be1edg jo pouzeY 


TIT-Was 


co 


DIAGRAM SRM-7. IRARMCEN - Deferred Action Processor (2 of 2) 


Extended Description 


The Deferred Action Processor routes control to each 
requested routine for all OUCBs on the deferred action 
queue. The entry point descriptors for all possible 
action routines ere contained in RMCTEPOT, 


1 If SRMTQE is not on the system timer queue, pass 
control to IRARMEFIP to simulate a timer pop. 


2 iif the action queue header is pointing to the dummy 
pre-assembled OUCB (that is, RMCTAQHD= 
RMCTOUCB), then the action queue is empty. 


3 The top OUCB is dequeusd vis compare-anddouble- 
swap, to prevent multi-processing interaction 
problems. OUCBACT is set to - wo. 


4 IRARMCAT scans the FPDT entry point table 
looking for entry point blocks (RMEPs) whose invo- 

cation flags match “‘one’’ bits in the input bit pettern. 

For each successful match, the corresponding entry point 

is invoked. The invocation bit of each routine invoked 

is set to zero in the input bit pattern. it is possible for 

an action routine to call another action routine. in this 

case, the new routine request is inserted into the 

OUCBACN field, to be picked up during the processing 

of this OUCB. 


Module 


IRARMCTL 


IRARMCTL 


IRARMCTL 


IRARMCTL 


IRARMCTL 


C 


Label 


IRARMCEN 


IRARMCEN 
IRARMFIP 


IRARMCEN 


IRARMCEN 


IRARMCRT 
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DIAGRAM SRM-8. IRARMCEL - Algorithm Request Processor (1 of 2) 


Sequential flow in 
SRM control 
mainline 
(IRARMCTL) 


Input Process 





RMCT 
1 Verify that some algorithms have 


been requested. 
RMCTALR 
No algorithms requested 


2 Combine the deferred and 
immediate algorithm requests. 


RMCTEPAT 3 Route control to the necessary 


algorithms. 








Continue SRM 
control processing 


Continue SRM 
control processing 


Output 
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DIAGRAM SRM-8. IRARMCEL - Algorithm Request Processor (2 of 2) 


Extended Description Module Label 


The algorithm request processor routes control to all IRARMCTL IRARMCEL 
algorithms that have been requested and can now be 

executed. The entry point descriptors for all possible 

algorithm routines are contained in RMCTEPAT. 


1. Algorithms are requested if RMCTALA and RMCTALR IRARMCTL IRARMCEL 
are not both zero. Algorithm requests are stored in 

RMCTALR by SRM locked routines, and in RMCTALA by 

SRM unlocked routines. 


2 Compare and swap logic is used to insure that all IRARMCTL RMCELL1 
current requests are obtained for a multiprocessing 
environment. 


3  'RARMCRT scans the EPAT entry point table IRARMCTL IRARMCRT 
looking for entry point blocks (RMEPs) whose 

invocation flags match “one” bits in the input bit pattern. 

For each successful match, the corresponding entry 

point is invoked. For each algorithm called, the invo- 

cation bit is set to “zero”’ in the request bit pattern. 

Input parameters: 


@ reg. 1 — address of first entry point block (RMEP) 
in the EPAT chained table 


@ reg. 6 — address of input Lit pattern (RMCTALR) 
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DIAGRAM SRM-9. IRARMCET - Periodic Entry Point Scheduling (1 of 2) 


Input 


RMCT 
Pel 
RMCTTMQE 


RMCTTOD 










RMEPFLG 

fe = 
RMEPTME 
RMEPINT 





From SYSEVENT 
processor as a result 


f SYSEVENT 01 
are Process 


| 
| 


Periodic Entry Point Scheduling (IRARMCET) 


1 Pick up the first algorithm entry point 
block from the timed algorithm queue. 


2 Verify that this algorithm is ready to execute. 





3 Seta request for executing this 
algorithm. 


4 Step to the next algorithm that is ready. 


5 Reset the timer expiration. 


invoke SRM control 
(IRARMCTL) 





Output 


IRARMSRV 


IRARMIO0S 
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DIAGRAM SRM-9. IRARMCET - Periodic Entry Point Scheduling (2 of 2) 


Extended Description 


Periodic entry point scheduling is invoked following 
timer initialization. (t sets up requests for all SRM 
periodically scheduled algorithms that are then due. 
It also requests the setting of the first SRM TQE to 
cause an interruption when next required. After the 
initial setting of the TQE, the TIME (05) SYSEVENT 
initiates the SRM timer queue expiration processing. 


1. =‘ The timer algorithm queue is ordered by the 
RMEPTME value of the RMEP blocks on the 
queue. 


2 An algorithm on the time-driven queue is due 
if the RMEPTME value is less than the current time 
(RMCTTOD) + an allowable tolerance (RMPTTOL). 


3. = The algorithm request field is set up for later action 
by algorithm control routing (IRARMCEL). 


4 Thenext RMEP block is obtained from the queue. 


5 Anew timer interruption is requested for the greater 

of: the minimum scheduling period (RMPTT OM), 
and the smallest time due of a scheduled routine. (See 
Diegram SRM-1.) 


Module Lebel 


IRARMCTL IRARMCET 


IRARMCTL IRARMCET 


IRARMCTL IRARMCET 


IRARMCTL IRARMCET 


IRARMCTL IRARMCET 


IRARMSRV IRARMIOS 
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DIAGRAM SRM-10. IRARMCSI - Control Swap-In (1 of 2) 


From swap status change 
request (IRARMCRY) 


Input 


Process Output 








Register 4 ncaa 
urnc 


1 Check to see if the user is pO 
already swapped in. 


Return to swap status 


OUCBOUT 


scoala | User swapped in change request 
L_ tg 9 If the user is logically (IRARMCRY) 
swapped out, place the 
dispatching priority. IRARMIO2 entry point 


(ASCBCHAP request) 


Otherwise, go to step 4. 


IRARMSRV 


3 Post quiesce to start IRARMI16 entry point 
a logical swap-in. (post ECB) Return code 





4 Obtain a user contro! block IRARMSRV 


extension (OUXB) for the IRARMIO4 entry point 
user being swapped in. (obtain storage) Return code 


If the OUXB is not obtained. 





Return to swap status 
change request 


{(IRARMCRY) 
IRARMSRV 
5 Otherwise, initiate the IRARMIO7 entry point 
swap-in. (swap-in request) Return code 
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Return to swap status 


Successful swap-in. change request 
(IRARMCRY) Return code 
Otherwise, free the OUXB : 
storage. 
IRARMSRV 


IRARMIO4 entry point 
(free storage) 


Return to swap status 
change request 
(IRARMCRY) 
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DIAGRAM SRM-10. IRARMCSI - Control Swap-In (2 of 2) 


Extended Description 


Control swap-in accepts a request that an address space 
be swapped in. If the address space is already swapped 
in, a return code is set; if not, control swap-in initiates 
a swap-in of the address space. 


1 Control swap-in returns to the calling routine 
with a return code of 8 if the user for which 

a swap-in has been requested has already been 

swapped-in. Otherwise, contri goes 10 step 2. 


2? To expedite quiesce processing, request that 

the user’s address space dispatching priority 
be reset to the dispatching priority associated with 
it before it was logically swapped. 


3 IRARMI16 will accomplish a cross-memory post 
by scheduling an SRB in the address space to 
be posted. 


4 The user control block extension (OUXB) is 
obtained. It remains in existence as long as 
the user is swapped in and is released at swap-out. 


5 if the swap-in is successfully initiated 

(return code from IRARMIO7 equals 0), 
the OUXB is cleared, the address of the OUXB is 
placed into the ASCB (ASCBOUXB), and the 
OUCB going-in bit is set (QUCBGOI!). 


Otherwise, the storage for the OUXB is freed. 


Error Processing: 


it an attempt to obtain storage for an OUXB fails 
(step 4), or an attempt to initiate a user swap-in 
fails (step 5), the user remains on the OUT queue, 
and control swap-in returns to the caller with an 
error return code. 


Cc 


Label (or 
Module Segment) 


IRARMCTL IRARMCSI 


IRARMCTL (IRARMCSI 


IRARMSRV IRARMIO2 


IRARMSRV IRARMI16 


IRARMSRV IRARMIO4 


IRARMSRV IRARMIO7 


IRARMSRV IRARMIO4 


IRARMCTL IRARMCSI 
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DIAGRAM SRM-11. IRARMCSO - Control Swap-Out (1 of 4) 











From swap 
status change 
request 
Input (}RARMCRY) Process Output 
Control Swap-Out (IRARMCSO) 
Register 4 
ee 
— —- —— 1 If the user is already swapped out, 
OUCBOUT go to step 5. Otherwise, continue. 
rire eae 
OUCBASCB 
= = 
IRARMSRV 
2 Initiate a swap-out of the IRARMIOG 
ASCBECB current user, by posting cross memory 
the region control task. post 
nara 
Return 
code 
if unsuccessful 4 | 
Register 4 Return to 
swap status 
change request 
(IRARMCRY) 
OUCBAPG Otherwise, continue. IRARMCPM 
Ree 3 \f the user is in the automatic IRARMSWT 
priority group (APG), switch switch 


out of the time-slice/rotate 

groups and, if necessary, mark 
the appropriate algorithms IRARMCPM 
inactive. 





IRARMACT 
activate 
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DIAGRAM SRM-11. IRARMCSO - Control Swap-Out (2 of 4) 


Extended Description Module Label 


Control Swap-Out accepts a request that an address space be IRARMCTL IRARMCSO 
swapped out. If the address space is already swapped-out, 

a return code is set; if not, control swap-out initiates 

the swap-out of the address space. 


1. Control swap-out skips to step 5 if the user for which IRARMCTL IRARMCSO 
a swap-out has been requested has already been 

swapped-out, as indicated by the OUCBOUT bit. Otherwise, 

control goes to step 2. 


2 ~The supervisor service request routine requests the IRARMSRV IRARMIO6 
initiation of quiesce processing for the user to be 

swapped out. This request results in the posting of an 

ECB for the indicated address space, so that the RCT 

will begin quiesce processing. 


A successful return from I|RARMIQ2 indicates that the 
post of quiesce processing has been scheduled for the 
address space. The process of quiesce processing will be 
indicated to the SRM by future SYSEVENTs (typically, 
quiesce started, followed by quiesce completed, followed 
by swap-out complete). 


3 Users are removed from time-slice group for IRARMCPM IRARMSWT 
the duration of swap-out. IRARMACT 
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DIAGRAM SRM-11. IRARMCSO - Control Swap-Out (3 of 4) 


Process 


4 If swap-out is successfully initiated, 
place user at top of the dispatching 
queue and 


pass back successful return code. 


From 
step 1 





5 If the user is not logically swapped 


Otherwise, continue. 


G CHAP the user to the highest 
priority. 


7 Post quiesce to continue the 
swap. 





UL 


Output 





IRARMSRV 


IRARMIO2 
ASCBCHAP 
request 
















Return 
code 
Return to swap 
status change 
request Ret 
(IRARMCRY) tntiely 





Return to 
swap status 

change request 
(IRARMCRY) 








IRARMSRV 


IRARMIO2 
call ASCBCHAP 


IRARMSRV 


IRARMI16 
post quiesce 






Return code 


Return to swap 
status change request 
(IRARMCRY) 
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DIAGRAM SRM-11. IRARMCSO - Control Swap-Out (4 of 4) 


Extended Description Maodeute Label 


4 To expedite quiesce processing, request that the user's 
ASCB be moved to the highest priority. IRARMSRV IRARMIO2 


5 Test swapped-out users to ensure that they are logically 
swapped. Users already physically swapped cannot 
be reswepped. A return code >f 8 indicates this error. 


G6 To expedite processing, request that the user's ASCB 
be moved to the highest priority. IRARMSRV IRARMIO2 


7 Call IRARMI16 to post the quiesce ECB by preposting IRARMSARV IRARMIIG 
it or by scheduling an SRB into the address spece. The 

swep-out complete SYSEVENT is issued when the swap-out JIRARMSRV IRARMI17 

is finished. 
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IRARMSWP MODULE ENTRY POINT SUMMARY 


ITRARMCAP Swap analysis algorithm. Attempts to keep the multiprogramming level 
(MPL) at its target level in each domain by performing user swaps. 


LRARMCPI Select swap-in candidate subroutine. Scans the OUT queue for the user 
in a particular domain with the highest recommendation value. 


IRARMCPO Select swap-out candidate subroutine. Scans the IN queue for the user 
in a particular domain with the lowest recommendation value. 


IRARMCVL User swap evaluation routine. Computed a numerical value representing 
the recommendation of a user to be swapped in. This recommendation 
value is the sum of the user's workload level and the recommendations 
of the I/0 and CPU resource managers. 


IRARMSA7 Deferred migration swap redrive algorithm. Reattempts any migration 
swaps deferred by storage shortages when enough storage is available. 


LY28-1760-0 (cc) Copyright IBM Corp. 1987 Method of Operation SRM-123 
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DIAGRAM SRM-12. IRARMCAP - Swap Analysis (1 of 2) 


From algorithm 
Input request (IRARMCEL) Process Output 


Register 2 a Swap Analysis (IRARMCAP) Comain 


RMCT descriptor table 
1 Reinitialize the domain descriptor table. OMDT 





Ld 


2 Perform DEFER SWAP-INs. Swap in as 





many deferred express users as possible. If 
RMCTINQE enough storage is available to swap in all 
i deferred express users, then swap in as 
many deferred non-express users as available 
RMCTOTQE storage permits. 
[re FG 
RMCTDMDT Perform a UNILATERAL SWAP-OUT. 
os Swap-out the users in domains having a 


multi-programming level (MPL) greater 
than the target. 


Bal 


Perform an EXPRESS SWAP-IN. Swap in 
the express user that has been swapped out 
the longest time. If there is not enough 
storage for the swap-in, defer the user. 





Return to 
algorithm 
request 

(IRARMCEL 






if a swap or defer occurs 






Domain descriptor table 
DMDT 


Perform a UNILATERAL SWAP-IN. Swap- 
in the users in domains having a MPL less 
than the target. 
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Perform an EXCHANGE SWAP. Swap- 

out the user with the lowest recommen- 

dation value (RV) in each domain whose 
highest user RV exceeds the lowest by a 
threshold. 


Return to 
algorithm 
request 
(IRARMCEL) 
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DIAGRAM SRM-12. IRARMCAP - Swap Analysis (2 of 2) 


Label (or 


Extended Description Module Segment) 


Swap analysis is performed on a time-driven basis. It is an IRARMSWP IRARMCAP 
algorithm activated by IRARMFOS. It is also activated by 

the processing of three SYSEVENTS: USERRDY (04), 

SWOUTCMP (OF), and QSCECMP (0C). 


1. The domain descriptor table has one entry for each IRARMSWP IRARMCAP 
domain defined by the IPS. Each OUCB on the IN 

and OUT queues is examined. Swappable, valid users on 

the IN queue which are not in the process of being swapped 

out or Moving from one SRM queue to another are 

counted in the current multiprogramming level (MPL) 

for a domain, as well as users on the OUT queue which 

are being swapped in. An inst?'lation option allows 

non-swappable users to be cuunted in the current MPL 

for adomain. Fields in each 2smain descriptor table 

entry are reinitialized with the above MPL count 

information. 


Note: 


A terminating address space that is swapped out is not 
counted as a swapped out user in the domain table and 
is not considered for swap-in. 


2 ‘Find the users that were previously picked for swap-in, 
but were deferred because of insufficient storage. 
(When a swap-in is deferred, SRM temporarily steals storage 
at a faster rate until enough ctorage is available to complete 
the swap-in). Swap-in as many deferred express users as will 
fit into storage. (An express user is a user that is enqueued 

On a resource and is either non-swappable or is being 
canceled). If enough storage is available to swap in all de- 
ferred express users, then swap in as many deferred non- 
express users as available storage permits. For deferred 
swap-ins, IRARMCAP chooses first the users that have been 
swapped out the longest time. 


IRARMSWP IRARMCPO 
IRARMCTL IRARMCSO 


3 Search the domain descriptor table entries fora 

domain with an MPL higher than the target value 
and swap-out the user with lowest recommendation value 
(RV). Repeat until the MPL reaches the target value in 
every domain. 


Cc 


Label (or 


Extended Description Segment) 


Module 


3. (continued) 


If at least one swep is performed in this step, swep 
analysis ends here. Otherwise, continue at step 4. 


4 _siIf there are any express users on the OUT queue, at- IRARMCTL IRARMCSI 
tempt to swap in the express user that has been 
swapped out the longest time. If there is not enough stor- 
age for the swap-in, defer the user. If the MPL in that do- 
main is less than the target, swap that user in. If the MPL 

is not less than the target, make room for the user by a 
swap-out of the user with the lowest RV. Repeated calis 
to swap analysis may be necessary to reduce the MPL be- 
low the target value to allow the express user to be 
swapped in. if there is no swap or defer, continue to step 
5. Otherwise, swap analysis ends here. 


IRARMSWP IRARMCPO 
IRARMCTL IRARMCSO 


5 = Search the domain descriptor table entries for a 

domain with an MPL less than target and swap-in the 
user with the highest RV. Repeat until the MPL (plus 
users in the process of being swapped out) reaches the tar- 
get in each domain. If there is not enough storage for a 
swap-in, defer the swap-in until the next invocation of 
swap analysis. (See step 2). If at least one swap or defer 
is done in this step, swap analysis ends here. 


IRARMSWP IRARMCPI 
IRARMCTL IRARMCSI 


G Search the domain descriptor table entries for a do- 

main with an MPL that equals the target for that do- 
main. In this domain, find the out-of-storage user with the 
largest RV to come in, and the in-storage user with the 
smallest RV to remain in. (If the difference of their RVs 
exceeds a threshold (RMPTXCHT), swap out the user with 
the lower RV. This exchange swap is only done for one do. 
main. 


IRARMSWP IRARMCPO 
IRARMCPI 
IRARMCTL IRARMCSO 


Error Processing: 
e IRARMERR handles all unexpected errors. 


e@ Any non-zero return codes from called routines 
Cause swap analysis (IRARMCAP) to end without 
finishing its processing. 
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DIAGRAM SRM-13. IRARMCPI - Select User for Swap-In (1 of 2) 


Input 


Register 11 


RMCT 


RMCTOTQE 


From swap 
analysis (IRARMCAP) 


Process Output 


1 Compute the composite recom- 
mendation value (RV) for each user 
(in domain) on the OUT queue, 
that is not already scheduled 
for a swap-in. 


2 Select the user with the 
highest RV. 


Return to swap 
analysis (IRARMCAP) 


Register 4 
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DIAGRAM SRM-14. IRARMCPO - - Select User for Swap-Out (2 of 2) 


Extended Description Module Label 


This routine chooses the user with the lowest RV in a IRARMSWP IRARMCPO 
particular domain on the IN queue. If one of the users 

represented by en OUCEB in the domain is assigned to a 

different domain, for example, because of a period change, 

return a code of zero indicating no user found. In this 

case swap analysis (IRARMCAP) is rescheduled to ensure 

that the domain descriptor tabie is initialized to reflect 

this domain change. 


The following two steps are performed in a loop until all 
OUCB’s on the IN queue have been evaluated. 


1 Examine each OUCB on the IN queue for users IRARMSWP IRARMCPO 
in the specified domain. Use the user evaluation 

subroutine to compute the composite RV for each user. IRARMSWP IRARMCVL 

2 Compere the computed RV to that of the lowest IRARMSWP IRARMCPO 


RV up till now. Save this OUCB as the best 
candidate for a swap-out if its RV is lower. 


Otherwise, continue until all OUCBs in this domain on 
IN queue have been evaluated. 
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DIAGRAM SRM-15. IRARMCVL - User Evaluation (1 of 2) 


input 


Performance 
group 
descriptor 


Workload 
Manager 
specification 
table 


From select user for swap-in (IRARMCPI) or 
select user for swap-out (IRARMCPO) 
Process 








RRPA 
eas 

RRPATOD 1 Check to see if a workload manager 
So recommendation value has been 


computed within a tune less than a 
OUCB 


threshold 
er: 


OUCBTMA 
Pee 
if the computation is recent 
wPGD OUCB 2 


| Calculate the new workload 
{| OUCBTMP Manages secommendation value. 
WPGLISV | -————_ 
QUCBWMS 
ae: 










WPGLDUR 


RRPA 





RRPATOD OUXBPRS 
eee) 
OUXBTRS 





Performance 
WMST objective 


[| 


3° If the load balancers are 
requested, calculate the 


ASCB OUXB 
OUCB composite RV, based on 
1/O, storage and processor 


OUC&8WMH usage: 


OUCBSTB 
OUCBCTB 
OUCBITB 


Return to caller 





Go to step 3 








Output 





OUCB 


OUCBWMR 
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DIAGRAM SRM-15. IRARMCVL - User Evaluation (2 of 2) 
Extended Description Module 


User evaluation computes a recommendation value (RV) IRARMSWP 
fo: one user based on its wo: kload manager 

recommendation value and its |/O, storage and processor 
recommendation values. 


1 Anew value is calculated for the workload manager IRARMSWP 
RV only if sufficient time has elapsed since its 

previous calculation. (Swap analysis evaluating thres- 

hold RMPTSAET). 


2 Compute the workload manager recommendation IRARMWLM 
value (the normalized workload tevel) representing 

the desirability Of a swap of this user This value is based 

on the rate at which the user has recently been receiving 

service and on the IPS 


3 .~—=sCf the applicable RTB value is 1, add to the workload IRARMIOM 
level an 1/O manager recommendation value (for 

significant users of 1/0), add a processor manager IRARMCPM 

recommendation value (for significant users of the processor 

resource), and add a storage manager recommendation 

value (for significant users of storage). A positive RV favors 

the swap-in of a user to correct a storage or 1/O imbalance IRARMCPM 

and a negative RV favors the swap-out of a user. 
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Label 


IRARMCVL 
IRARMCVL 


IRARMWM3 


IRARMIL3 


IRARMCL3 


IRARMMS3 
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IRARMSTM MODULE ENTRY POINT SUMMARY 


XCKSIGUR 
TRARMMS3 


TRARMPR1 


TRARMPR5 


TRARMPR9 


X¥STEAL 


XSTMFENCE 


XSTORUSE 


Storage load balancing. Monitor significant users of real storage. 


Storage load balancing swap evaluation. Produce a numerical 
recommendation value that reflects the eligibility of a user to be 
erect aes on the use of real storage and the contention for real 
storage). 


Page replacement normal processing. Examine each user in main storage 
and the system pageable area and call RSM to update UICs for each user. 


Page replacement real page shortage force steal. Steal as many frames 
as required to relieve a real page frame shortage. The steal decision 
is made at entry IRARMMS2. The oldest unreferenced system-wide frames 
are stolen first. 


Swap out trim routine. Trim user logical swaps by think time and for 
swap-outs to auxiliary storage and extended storage. 


Internal IRARMSTM steal subroutine. Add users to interface list until 
full, then call RSM steal routine CIARXSF via IRARMI0O3) and record the 
number of pages stolen. 


Storage isolation. Calculate the target working set sizes for address 
spaces and the common area if controlled by the page-in rate. 


Storage load balancing. Monitor real storage utilization. 


X¥Internal subroutine 


SRM-132 MVS/XA SLL: Sys Res Mgmt LY28-1760-0 (Cc) Copyright IBM Corp. 1987 


J 


"Restricted Materials of IBM" 
Licensed Materials — Property of IBM 


A ODU TRY POINT SUMMAR 


IRARMMS2 


IRARMMS4 


IRARMMS5 


TRARMMS6 


TRARMSQA 
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Real page shortage prevention. As frames are needed, finish deferred 
swaps to extended storage and physically swap users that have been 
logically swapped for too long. After this, if a real page shortage 
exists, schedule IRARMPRS5. If a pageable frame shortage exists, inform 
the operator of the shortage and of the users that might have caused 
the shortage condition and the amount of fixed and real storage pages 
allocated to these users. Direct the swap-out of these users. 


Threshold adjustment routine for storage load balancing and pageable 
storage shortage processing. Increase or decrease the threshold used to 
determine which address spaces are considered significant users of real 
storage. Calculate the percentage of users that are eligible for 
storage load balancing and that are considered significant users of 
real storage with the existing threshold. The threshold is increased to 
keep the percentage of significant users at a constant percentage of 
the eligible users. 


Increase or decrease the threshold used as the median fixed frame count 
for all ready address spaces, and the threshold for TSO address spaces 
swapped out for terminal wait. The medians are used by pageable storage 
shortage processing and logical swapping to assess a user's impact on 
pageable storage. 


Pageable storage shortage calculation. Calculates the thresholds for 
pageable storage detection and relief for use by RSM and SRM. 


Main storage occupancy long wait detection. Discover user that have 
gone into long wait without notifying SRM. Swap out such users, if they 
are swappable. 


SQA shortage message writer. Inform the operator of system queue area 
shortages. Signal SQA shortage using event notification facility CENF). 
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OUCBTWSS 
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From algorithm processor (IRARMCEL) 
as a result of a request by periodic entry 
point scheduling (IRARMFOS5) 


OUCB 
in queue 


OUXBs 


ie eens] 
OUXBPIN 
a a 
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CE 


RCECOMPI 


Process 
IRARMPR1 \ 


DIAGRAM SRM-16. IRARMSTM, IRARMST2 - Storage Management (1 of 14) 


See M.O. diagram 


Update UiICs 


(IARXUU) Output 


OUXB 





les ee 
ASCBFMCT 


Pee ee ee ae 
Execution time 
ae ee 


1 (f due update the UICs for each 
swappable user in main storage. 


Adjust the time intervals before the 


next UIC update for common, 
swappable, and non-sweppeble 
address spaces. 


If due, update the UICs for each 
non-swappable user. 


If due, update the UICs for the 
system pageable area. 


2 Determine if the address space 


is a significant user of real storage. 


3 Determine the target working 
set size for each address space 


protected by real storage isolation. 


4 Determine the target working 
set size for the common area. 







Update UICs 


IARXUU 


Update UICs 











OUCB 


OUCBSBFC 


OUCB OUXB 
eS Ree ee 
OUCBTWSS OUXBSIPR 
es a eeeaee? 

MCT 
es 
MCVTWSS 


MCVSIPR 
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DIAGRAM SRM-16. IRARMSTM, IRARMST2 - Storage Management (2 of 14) 


Module lL abel 


Extended Description 

Storage management consists of essentially independent IRARMSTM 
routines that are invoked by SRM control or by the 

SYSEVENT processor to control the usage of main and 

auxiliary storage by all users. For non-swappable users 

(users whose fixed storage must remain in real storage), 

the mechanism of page stealing (freeing non-fixed pages 

for other use) is used for storage management control. 

For swappable users, both page-stealing and swapping 

provide the necessary control. 


1. ‘The frequency of updatng UICs for the common area, IRARMSTM IRARMPR1 


swappable, and non-swappable address spaces will cor- 
respond to every nth invocation of IRARMPR1, where n is 
calculated based on storage usage, which is indicated by the 
highest UIC of any page... the system. IRARMSTM schedules 
an SRB to update the UICs. This is done separately from 
other SRM processing to prevent SRM from disabling the 
system for excessive periods of time. 


IRARMSTM enters the RSM UIC update module (IARXUU) IARXUU 
to update the UICs for swappable and non-swappable users of 

storage and for the common area. [ARXUU updates the 

UICs for each address space passed in the parameter list. A 

zero ASCB address in the parameter list indicates the 

common area. 


IARXUU 


RSM examines the UICs associated with each of the user’s 
(or the common area’s) pages. If the page reference bit is on, 
the UIC for this page is set to zero, and the reference bit reset. 


If the reference bit is off, the corresponding UIC is increased 
by the value specified in the parameter list. RSM then saves 
the highest UIC count for this user (or the common area) in 
the corresponding entry in the parameter list. The highest 
UIC for the system pageable area is also saved in the cor- 
responding entry in the parameter list. The SRM saves the 
highest UIC for each user in the corresponding OUXB and 
the highest UIC for the common area in MCVCHUIC. 


UIC updating for common and non-swappable address 
spaces occurs on every nth invocation of IRARMPR1. n 
is recalculated based on storage usage, which is indicated 
by MCVSTCRI and the constants MCCNCLIM, 
MCCNCDEL, and MCCNCMAX. UIC updating for swap- 


Cc 


Extended Description Module Label 

pable address spaces occurs on every nth invocation of 

IRARMPR1. nis recalculated based on MCVSTCRI and 

the constants MCCSWLIM, MCCSWDEL, and 

MCCSWMAX. 

2 _=siIf storage load balancing is active and applicable to IRARMSTM CKSIGUR 
this address space, and the address space has accumu- 

lated enough execution time since it was last swapped in, 

{RARMSTM saves the number of frames owned by the 

address space in OUCBSBFC and determines if the address 

space meets the criteria for a significant user of storage. If 

it does, IRARMSTM indicates that it is a significant user 

(OUCBSBSU=1). 


3 If real storage isolation is applicable to this address STMFENCE 

space and the page-in rate control is in effect, 
IRARMSTM adjusts the target working set size based on 
(1) the minimum and maximum working set sizes speci- 
fied in the IPS and (2) the page-in rate for the address 
space. The page-in rate for an address space is defined as 
the average number of private area page-ins per second of 
execution time, except for address spaces executing in 
cross memory mode. In a cross memory environment only 
address spaces executing as the home address space accum- 
ulate execution time. Except at initilization, an address 
space that can be entered using a program call (PC) from 
another address space (ASCBXMEC=1) rarely executes as 
the home address space and, therefore, accumulates little 
or no execution time. The page-in rate for this type of 
address space is based instead On elapsed time and is de- 
fined as the average number of page-ins per second of 
transaction residency time. 


4 —siIf real storage isolation is applicable to the common 

area and the page-in rate control is in effect, 
{RARMSTM adjusts the target working set size based on 
(1) the minimum and maximum working set sizes speci- 
fied in the IPS and (2) the page-in rate for the common 
area. The page-in rate for the common area is based on 
elapsed time and is defined as the number of CSA and 
PLPA page-ins per second of elapsed time. 


IRARMPR1 
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DIAGRAM SRM-16. IRARMSTM, IRARMST2 - Storage Management (3 of 14) 


Input 


MCT 
ar? 
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fe 
MCVSBLTS 
aaa 





Process 


5 Find the highest system UIC. 


6 Monitor real storage utilization and 
calculate the storage loed balancer 
swap recommendation factor. 


Return 

to algorithm 
processor 
(IRARMCEL) 


Output 


MCVSBLTS 


MCVSBFQA 


MCVSBRVF 
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DIAGRAM SRM-16. IRARMSTM, IRARMST2 - Storage Management (4 of 14) 


Extended Description Module Label 


5 = The highest UIC found in any address space or IRARMSTM IRARMPR1 
system pageable area tha: .s not protected by real 

storage isolation is identified and saved in MCVSTCRI. 

This value will be used by the force steal routine (Step 4) 

as the criterion by which RSM will begin stealing pages. 


6 _siIf storage load balancing is active, monitor storage STORUSE 
utilization and calculate the storage load balancer 

swap factor based on the long term average maximum UIC 

and the available freme count average. 
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DIAGRAM SRM-16. IRARMSTM, IRARMST2 - Storage Management (5 of 14) 


From algorithm processor as a result of eS 
a request by algorithm request 
Input (IRARMCRL) Process 








IRARMPRS 






MCT 


fee aed 
MCCSTLCT 


MCVFRCNT 
MCVSTCRI 


In queue OUCB 
header in queue 















7 Steal as many frames as required to 
From algorithm 








processor as a decision to steal is made at 
result of a IRARMMS2 (see step 8). 
Wait queue = request by 
header algorithm request 


(IRARMCRL) 
OUCB 
wait queue 


ea 


IRARMMS2 





MCT 


MCTAVAQI 8 If AVOLOW level 1, 2, or 3, cal- 


culate the number of frames 
needed to be stolen and schedule 


Also, reschedule IRARMMS2. 





relieve the real frame shortage. The 


IRARMPRS (step 4) to be executed. 


Output 









IRARMSRV 


IRARMIO03 
XSF interface 


Return to algorithm 
processor (IRARMCEL) 





Return to algorithm 
‘processor (IRARMCEL) 


Sees 
OUXBSTCT 
Pe 


MCTFRCNT 


era: 
RMCTALA 
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DIAGRAM SRM-16. IRARMSTM, IRARMST2 - Storage Management (6 of 14) 


Extended Description Module Label 


7 ~=«‘The real page frame shortage force steal routine is a IRARMSTM IRARMPR5 


co-operative effort between the SRM and RSM. STEAL 
SRM calls the RSM routine, IARXSF, passing a para- CKSIGUR 
meter list consisting of the following: STORUSE 


IRARMSRV IRARMIO3 
IRARMSTM IRARMPRS5 


An in-storage user’s ASCB address 

The number of frames needed from this address space 
The type of frames required 

A steal criterion number, MCVSTCRI 

Destination indicators for changed and unchanged pages. 


The SRM also passes to the RSM, in register 0, the total! 
number of frames required. 


If real storage isolation is specified in the IPS for any 
address spaces or the common area, locate ail such ad- 
dress spaces. If any address space or the common area 
exceeds its maximum working set size, frames are stolen 
until either the shortage is relieved or the working set 
sizes of the address space or the common area are equal 
to its Maximum working set size. Also examine each 
swappable address space to determine if it is a signifi- 
cant user of storage (step 2). 


If a real page frame shortage still exists after trimming 

all such address spaces and the common area to their max- 
imum working set sizes, frames will be stolen from logically 
swapped address spaces that «vere allowed to keep their 
standard working set pages and pages that were recently 
referenced. These users will be trimmed to the frames 
backing their working set. If a real page frame shortage still 
exists after trimming, frames will be stolen from the com- 
mon area and all address spaces on the SRM IN queue. 


Since MCVSTCRI is the largest UIC in the system, the 
steal criteria starts at this UIC. Frames with a VIC 
greater than or equal to the «eal criteria are stolen from 
each user. During this processing, if real storage isolation is 
applicable to a user or the common area, frames will not 
be stolen if it would reduce the user’s or the common 
area‘s working set below its target working set size (as- 
suming that enough frames can be stolen to relieve the 
shortage without violating this rule). If frames are still 
required after all eligible user’s frames have been stolen 
at this criteria, the steal criterion will be decreased and 
the process repeated until no further frames are required. 


C 


Extended Description Module Label 


7 = (continued) 


The result of this procedure is that the oldest unreferenced 
system-wide frames are stolen first. Frames in the com- 
mon system area and link pack area are not associated 
with any specific user. RSM examines these frames when 
SRM page replacement calls it with an ASCB address 

of zero. 


The order of stealing at any criterion level is as follows: 
a) Address spaces that are capable of executing 
b) Common system area 


If a shortage still exists, additional frames are stolen in 
the following order: 


a) Working sets of logically swapped users 
b) Frames protected by storage isolation in UIC order 


Storage utilization is monitored (see step 6) after all 
steal processing is completed. 


Normally, SRM directs changed and unchanged pages to 
auxiliary or extended storage using the appropriate criteria 
table entries. Changed pages are either sent to extended 
storage Or auxiliary storage, and unchanged pages are either 
sent to extended storage or discarded. If there is no extended 
storage online, or extended storage migration is constrained 
or overdue, changed pages are directed to auxiliary storage 
and unchanged pages are discarded. If frames are needed 
synchronously for a swap-in, changed pages are directed to 
extended storage and unchanged pages are directed by the 
criteria table. 


8 The SRM will have received an AVOLOW 
SYSEVENT if there is a shortage of real page frames. 
If the invocation is due to AVQLOW level 1, 2 or 3 (real 
page frame shortage), and an AVOOK SYSEVENT has not 
been issued, calculate the number of frames needed to get 
the available frame queue back to the OK threshold and in- 
voke the forced steal algorithm via the algorithm request 
mechanism. [RARMMS2 will be rescheduled for execution 
via the algorithm request mechanism. 


IRARMST2 IRARMMS2 


IRARMCTL IRARMCRL 
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DIAGRAM SRM-16. IRARMSTM, IRARMST?2 - Storage Management (7 of 14) 


From algorithm processor (IRARMCEL) 


as a delayed algorithm request or 
directly from the algorithm request if 


the SRM lock is held. 


wD 
Hil 
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RCECNTFX 
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DMDT 


a 
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Process Output 









IRARMMS2 







Q If there is a shortage of pageable 
real storage frames, notify the 
operator. 





IRARMSRV 


IRARMIOS 
issue a msg 


IRARMCTL 


IRARMCSO 
control 
swap out 


IRARMSRV 


IRARMI20 
obtain fix 
counts 







Message to 
operator 











—— 











@ Swap out the address space(s) 
using large amounts of real 
storage. 











If a shortage still exists, phy- 
sically swap out logically 
swapped users. 






If there is still a shortage 
of real frames, reduce the 
MP Ls for domains and 
schedule swap analysis. 









DOMDTMPLT 






IRARMCTL 


IRARMCRL 
algorithm request 


schedule 





Return to algorithm 
processor 
(IRARMCEL) 
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DIAGRAM SRM-16. IRARMSTM, IRARMST2 - Storage Management (8 of 14) 


Extended Description Module Label 


IRARMMS2 is periodically scheduled to calculate the logical 
swap available frame queue target, and if there are less avail- 
able frames than the target, to process logically swapped 
users on the logical swap WAIT and OUT queues until the 
target is reached or there are no more such users. 


As frames are needed, users who are suspended for swap- 
Out to extended storage are redriven. Users who are targeted 
for extended storage are trimmed, built (secondary WS), 
and swapped out. Users who are logically swapped by think 
time are physically swapped if their think time exceeds the 
system think time criterion. 


Q IRARMMS2 is scheduled to relieve a pageabie stor- 
age shortage: 
e By IRARMMSS routine when the pageable storage 
shortage thresholds have changed and a shortage exists 
with the new thresholds. 


IRARMST2 IRARMMS2 


e@ When a pageable real frame shortage is indicated by 
SYSEVENT ANQLOW le. .| 4 from RSM. 


@ When SRM detects a pageable real frame shortage. 


The shortage processing checks for two levels of short- 
ages, an initial shortage condition and a critical shortage 
condition. A message describing the current shortage 
level is written to the console. When the pageable frame 
shortage is relieved, an additional message is written to 
indicate the alleviation of the shortage. 


IRARMSRV_ IRARMIOS9 


| C 


Extended Description 


Module Label 
(continued) 


If the shortage is due to fixing, the address spaces 
using large amounts of fixed storage are swapped out. 
If the shortage is due to paging, the address spaces 
using the largest amounts of real storage are swapped 
out. A message is issued to the system operator indi- 
cating the amount of real storage allocated to the ad- 
dress space and the subset of this amount that is fixed. 


if the shortage was due to fixing and enough fixed stor- 
age has not been reclaimed, some or all of the logic- 
ally swapped address spaces are swapped out. 


If a shortage due to fixing still exists after all of the 
logically swapped address spaces have been swapped out, 
the multiprogramming level(s) (MPLs) for the domain(s) 
with the lowest contention index is reduced. Swap analysis 
is then scheduled to swap out the address spaces with the 
lowest recommendation values. 
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DIAGRAM SRM-16. IRARMSTM, IRARMST2 - Storage Management (9 of 14) 


Input 


RMCT 


RMCTINQGQE 
RMCTWTQE 
RMCTOTQE 


Wait queue 


OUCB 
in queue 














Out queue 


OUCB 
in queue 






Execution 
time 


Process 


From algorithm 
processor 
(IRARMICEL) as 
a result of a 
request by 
periodic entry 
point 

scheduling 
(1RARMCET) 


IRARMMS6 


10 Request the swapping of users 
determined to be in a wait state 
for a sufficient period of time. 





IRARMCTL 


IRARMCSO 


control 
swap out 





Return to algorithm processor 
(IRARMCEL) 


Output 


Base 
values 
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DIAGRAM SRM-16. IRARMSTM, IRARMST2 - Storage Management (10 of 14) 
Extended Description Module Label 


10 Users who issue a long wait macro instruction will IRARMST2 IRARMMS6 
be detected by SRM when the wait macro pro- 

cessor issues the NIOWAIT SYSEVENT. Users who do 

not issue a long wait macro instruction to notify SRM 


that they will be in the wait state for a long time will be 
detected by IRARMMS6 when they satisfy the following 


conditions: 


e@ they have gone without executing for a sufficient period 
and 


@ they have no ready work or they have vector work and 
no processors with a Vector Facility currently online, 


SRM might allow these users to be logically swapped in case 
the user becomes active again. The decision to logically 
swap or not is based on the current storage usage. 
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DIAGRAM SRM-16. IRARMSTM, IRARMST2 - Storage Management (11 of 14) 















From algorithm processor (IRARMCEL) as a delayed 
algorithm request (IRARMCRL) or directly from 
if the SRM lock is held. 
Inpu t algorithm request if the S ock is | e Process Ou tpu t 
RCE none IRARMMS5 RACE 
aa eae ear 
Ld 11 Calculate the frames for logical RCEMAXFX 
and physical pageable storage 
RCEPOOL shortage thresholds. Ifa 
shortage exists, schedule 
RCEBELPL IRARMMS2. 
Od Return to algorithm MCCLGCRI 
processor 
(IRARMCEL) MCCPHCRI 
MCT From algorithm 
processor as a MCCLGFOR 
result of a 
request by MCCPHFOK 
MCCFXTPR algorithm request 
i (IRARMCRL) MCCMAXFX 
or as aresult ofa 
MCCF XEPR request by periodic 
MCCFXEPR entry point RMCTALA 
IRARMSOA 
MCT 
eee 
RCT inform system operator of a 
12 MCTOFLGS 
ro =a eee, 


RCCFXTTH 


RCCFXETH 





critical system queue area page : 

shortage, or of the alleviation 

of such a shortage. Signal 

shortage using ENF. 
IRARMSRV 
IRARMIO9 a 
issue msg 


IRARMSRV 


IRARMI11 
ENF notification 






Message 
to operator 


MCT 


MCTSFLGS 


MCTOFLGS 


Return to algorithm 


processor 
(IRARMCEL) 


cL c 
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DIAGRAM SRM-16. IRARMSTM, IRARMST2 - Storage Management (12 of 14) 


Extended Description Module Label 


11 IRARMMSSG is called by RSM vis SYSEVENT 16 
(RSMCNSTS) when the reel storage configuration is in- 
itialized or changed and by SET OPT processing 
(IRARMSOP) when the pageabie storage shortage thresh- 
old percentages might have changed. 
This routine calculates the logical and physical shortage IRARMST2 IRARMMSS5 
thresholds and the shortage-relieved thresholds from the 
Online frame counts (RCEPOOL and RCEBELPL) and 
the threshold percentages. If a shortage exists with the 


new thresholds, IRARMMS2 is scheduled to relieve the IRARMCTL IRARMCRL 

shortage. 

12 The system queue aree message writer is invoked by IRARMST2 IRARMSQA 
SYSEVENT SQALOW or SQAOK to write shortage IRARMEV2 [IRARME25 


messages to the system operator. Messages are aiso written IRARMEV2 IRARME26 
when SQA expands into CSA, warning the operator of 

possible SOA fragmentation. The messages cannot be 

written directly by the invoking routines because the SRM 

lock must be held. The SRM does not permit the creation 

of new address spaces when an SOA shortage exists. 

IRARMSOA issues an ENF signal (event code 4) when- 

ever the routine is entered because a shortage situation 

has occured or the timer interval for the routine has 

expired. 
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Input 


ASCB 






OUXBUIC 


LSCT RMCT 


psc] [ 
| [Tawertoo" 














Wait queue 
header 






OUCB 


wait queue 








OUCB out queue 
Out queue 


header 


DIAGRAM SRM-16. JRARMSTM, IRARMST2 - Storage Management (13 of 14) 


From action processor 


(IRARMCRN) 


Process 


IRARMPRY 


13 Determine what the size of the user’s 


working set should be. 











Return to algorithm 
processor 
(IRARMCEL) 


IRARMSRV 


IRARMIO3 
XSF interface 


Return to action 
processor 
(ITRARMCRN) 
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DIAGRAM SRM-16. IRARMSTM, IRARMST2 - Storage Management (14 of 14), 


Extended Description Module 


13 This routine is called to trim users who are being logically IRARMSTM 
swapped by think time, swapped to auxiliary storage, 

or swapped to extended storage. Trim pages are directedto IRARMSRV 

extended storage or auxiliary storage by the swap trim entries 

in the criteria table. 


Users being logically swapped by think time are trimmed to 
a level based on storage contention and, for storage-isolated 
users, not below their minimum working-set size. 


Users being swapped to auxiliary storage are trimmed to re- 
move all unreferenced pages which are not protected by a 
minimum working-set size, if any. 


Users being swapped to extended storage are trimmed and 
secondary working set pages are built using a target provided 
by the caller (MCVPR9TG) as the maximum number of 
Pages to steal. The user is trimmed to a leve! based on storage 
contention, and, for storage-isolated users, not below its 
minimum working-set size. If more pages are to be stolen, 
secondary working set is built on extended storage for the 
remaining pages. If the user’s secondary workingset is built, 
bit OUCBSWSB is set on. For an address space not logically 
swapped or not protected by storage isolation, |RARMPR9 
leaves the determination of the working set to the RSM. 
RSM places all pages that have the reference bit set to 1 in 
the swap-in working set. For logically-swapped address 
spaces, the user’s working set size is trimmed to a level based 
On storage contention, The logically swapped users that 
are protected by storage isolation are not trimmed below 
their minimum working set size. 


Label 


IRARMPRQ9 
STEAL 
IRARMIO3 


c 


Extended Description Module Label 
13 fcontinued) 


For an address space that is physically swapped and is 
protected by storage isolation, the SRM must ensure 

that the RSM does not trim a user below the minimum 
working set size for the address space. The SRM trims 

the pages to the minimum working set size and then 
notifies RSM to include the remaining pages in the working 
set. 


For a logically swapped address space that is (1) not pro- 
tected by storage isolation and (2) now being physically 

swapped, the SRM trims the user’s working set so that all 
the pages that have the reference bit set have a UIC of 0. 
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IRARMILO 


IRARMIL1 


TRARMIL3 


TRARMIL4 


TRARMIL5 


IRARMIL6 
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ENTRY POINT SUMMA 


I70 Load Balancing User I/0 Monitoring. Compute I/0 use profile for 
all swappable problem state users based on their use of each logical 
path. 


Identification of Significant I/0 Users. If I/0 load balancing is 
active and I/0 is out of balance, identify significant I/0 users and 
ensure that their use of the logical paths is being monitored. 


I/0 Load Balancing User Swap Evaluation. Compute numerical 
recommendation value which reflects desirability of swapping a user 
based on its logical path utilization. 


I/0 Load Balancing IMCB Deletion Routine. Clean up control blocks used 
in monitoring a heavy I/0 user at the end of the user job step. 


Selective Enablement Monitoring. Periodically determine the percent of 
I/O interruptions currently being processed by the Test Pending 
Interrupt (TPI) path in IQS and determine if this percent is within the 
thresholds specified in the IEAOPTxx member of SYS1.PARMLIB. 


Modify Processor I/O Enablement. Search for a processor whose I/0 


enablement status can be switched to the state specified in the input 
parameters to the routine. 
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DIAGRAM SRM-17. IRARMILO - I/O Load Balancing User 1/O Monitoring (1 of 4) 


From QSECT 
SYSEVENT (OC) 
in IRARMEVT 


or IRARMIL1 Process Output 


Input 











OUCB 





1 If not already available, 
obtain and initialize en IMCB. 


LPBT 
aa 


LPBWORK 


2 Obtain, by logical path, the total 
cumulative device connect times 
for all allocated devices. 








ASXBLCTB 


Lowest TCB 


Job step TCB 


ae 
TCBTCT 
(ee _ 


TCT 


a 
TCTIOTBL 
es: 


TCTIOT 


TCTCONN 
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DIAGRAM SRM-17. IRARMILO - I/O Load Balancing User I/O Monitoring (2 of 4) 
Extended Description Module Lebel 


1/0 load balancing user 1/O monitoring maintains detailed IRARMIOM IRARMILO 
information on logicel peth (LPB) utilization for heavy 

1/O users. This LPB information is used by other I/O load 

balancing functions to influence swapping decisions when 

heavy users ere using logical paths that are not out of 

balance (either over used or under used). 


This monitoring is done during processing of the quiesce- 
started SYSEVENT (SYSEVENT OC) or during e 
periodic check for significant 1/O users (IRARMIL1). 
iIRARMIL1 issues @ cross memory macro instruction to 
access the 1/O timing control table (TCTIOT). The 
TCTIOT is located in the user’s private area and contains 
monitoring source data. (See Diegram SRM-19). 


1 if 1/0 ioad belencing is ective and the user does not 

have an 1/O measurement control block (IMCB), obtain 
an IMCB if the user’s total (/O percent connect time is 
high enough (that is, higher than ICCMNIOR). 


2 Access TCTIOT, looking at all user data set 
declarations, and access all devices alloceted to each 

data set. Through the UCB, . .eociate the device with a 

logical peth, and sum the user’s device connect time by 


fogical peth using LPBWORK as 8 working variable for 


the summation. 
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DIAGRAM SRM-17. IRARMILO - I/O Load Balancing User 1/O Monitoring (3 of 4) 


Input 


aa 
OUCBIMCB 





Process Output 


3 Create or update the user LPB 
usage entry for each logical 
path on which the user has 
made requests. 


LPB 
usage 
entries 





Return to SYSEVENT (OC) 
QSCECT in IRARMEVT 
or IRARMIL1 





OUXB 


OUXBITD 
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DIAGRAM SRM-17. IRARMILDO - 1/O Load Balancing User 1/O Monitoring (4 of 4) 


Extended Description Module Label 


3 Step through all logical paths (LPBT entries), IRARMIOM IRARMILO 
and determine if the user has been monitored for LPB 

utilization. That is, determine if an LPB entry is 

established in the IMCB. Update various utilization fields. 

if an IMCB LPB use entry is not established, make room 

for an entry by relocating other LPB use entries so that 

entries are kept in LPBT order. Various IMCB fields are 

initialized for the new entry. 


Fields updated or created in the LPB use entries are: 


e IMBLPBO — offset to the e<sciated LPB within the 
LPBT 


e IMBCONNP — percent of connect time for the LPB 
because of 1/0 activity for this user 


e IMBCONNB — I/O connect time base value 


Fields updated in the OUXB are: 
e OUXBITD — I/O loed balancing base time 
@e OUXBILS — I/O service bese connect time 


Summary flags maintained in the IMCB are: 


e IMCBSLPU — indicstes the user is active on at least 
one LPB that is either overused or underused. 

e IMCBOVLP — indicates the user is active on at least one 
overused LPB. 


e IMCBUNLP — indicates the user is active on at least one 
underused LPB. 
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DIAGRAM SRM-18. IRARMILI - Identification of Significant 1/O Users (1 of 2) 


Input 





OUXB 
po ee 
OUXBITD 


ASCB 


ASCBDCTI 


From algorithm processor (IRARMCEL) after 
@ request by periodic entry point scheduling 
(IRARMCET) 


Process 


1 Begin collecting and 
updating detailed 
1/O data for significant 
I/O users. 


If the return code is not 
zero, turn off channel 
measurements. 


Return to caller 
(IRARMCET) 


IRARMIOM 


IRARMILO 
1/0 Load 
balancing user. 
1/O monitoring 


Output 





OUCB 


OUCBIOR 


OUXB 
een 


OUXBITD 
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DIAGRAM SRM-18. IRARMILI - Identification of Significant 1/O Users (2 of 2) 


Extended Description Module Label 


IRARMIL1 identifies significant 1/O users when I/O is out 
of balance, ensures that their use of logical paths is mon- 
itored, and calls IRARMILO to update I/O use information. 


1 If 1/0 load balancing is active and 1/0 is out of balance, IRARMIOM IRARMIL1 
IRARMIL1 scans the users in real storage and calculates 

the recent rate of |/O requests to determine the significant 

users of I/O and ensures that their use of logical paths is 

being monitored. if the rate of use is high enough or if IRARMIOM IRARMILO 

the user has been previously monitored, IRARMIL1 calls 

IRARMILO to update the I/O use data for this user in 

the IMCB of this user’s address space. To update the |/O 

use data, IRARMILO checks the UCBMBI, which is an index 

to the channel measurement block (CMB) and the device 

vector table (DBVT). 


2 \f an error condition has occurred, that is, the 
IRARMILO passes a return code of 4 to IRARMIL1, 
which calls IRARMMSP to turn off channel measurements. 
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DIAGRAM SRM-19. IRARMIL3 - I/O Load Balancing User Swap Evaluation (1 of 2) 


Input 





From user swap evaluation 
(IRARMCVL) 


Process Output 


1 Compute the initial 
I/O recommendation 
value. 


2 Adjust and scale 
the recommendation 
value. 


Return to swap evaluation 
(IRARMCVL) 


OUCBIRV 
OUCBTIO 
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DIAGRAM SRM-19. IRARMIL3 - I/O Load Balancing User Swap Evaluation (2 of 2) 


Diagram SRM-20. 1/O Load Balancing User Swap Evaluation (IRARMIL3) (Past 2 of 2) 


Extended Description Module 


The user swap evaluation routine determines the {/O 
recommendation value for a user if: 


e 1/0 load balancing is in effect, as specified in the 
user’s performance group period. 


@ The 10C coefficient in the [EAOPTxx 
SYS1.PARMLIB member is non-zero. The 
recommendation value depends on the degree 
to which each LPB is out of balance and the user’s 
contribution to the utilization of each LPB. 


1 An initial recommendation value is computed IRARMIOM 
for each entry in the user’s 1/O measurement control 

block (IMCB) using the LPB recommendation value and 

the percent of LPB use due to the user. IRARMUPD, 

the channel measurement update routine, periodically 

calculates the LPB recommendation value and flags the 

LPB if necessary, as being overused or underused de- 

pending on the threshold specified in the LIEAOPTxx 

member of SYS1.PARMLIB. 


2 The initial recommendation is adjusted to produce a IRARMIOM 
value that is not greater than twenty percent of the 
largest workload level. 


Label 


iRARMIL3 


IRARMIL3 
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DIAGRAM SRM-20. IRARMILS - Selective Enablement Monitoring (1 of 2) 


From algorithm processor (IRARMCEL) 
after a request by periodic entry point 
scheduling (IRARMCET) 


Input : Process Output 


CSD 
CSDCPUAL 


PCCAVT 















1 Count the total 
1/O interruptions 
processed by [OS TP! 
and (OS SLIH for each 
online processor and 
count the number of 
online CPUs. 



























PCCA 


PCCASLIH 
PCCASTPI 


ICT 


e If no CPUs for I/O 
interruptions, 
enables one. 

















IRARMIOM 

























2 Enable or disable a IRARMIL6 
processor for !/O Select a processor 

interruptions if the to enable or 
percent of recent TPI disable 







ICCTPILO 
ICCTPIHI 


interruptions exceeds 
the thresholds. 






ICT 
ICVTPIP 
ICVSLIHB 


ICVTPIB 
















Return to caller 
(IRARMCEL) 
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DIAGRAM SRM-20. IRARMILS - Selective Enablement Monitoring (2 of 2) 
Extended Description Module Label 


IRARMILS periodically checks to see if the number of 
processors enabled for {/O interruptions can effectively 
process the I/O workload. 


1 IRARMILS determines the number of 1/O inter- IRARMIOM IRARMILS5 
ruptions taken as interruptions (SLIH) and the number 

taken by the Test Pending Interrupt (TPI) instruction 

for each online processor. In addition, IRARMILS 

determines the number and type of processors that are 

online and enabled for interruptions. 


If there are no CPUs enabled for I/O interruptions, 
IRARMILS5 enables one. 


2 IRARMILS calculates the changes in the TP! and the IRARMIOM IRARMILS 
SLIH counts since this routine last ran. The routine then 

computes the percent of recent TP! interruptions compared 

to the total interruptions. If the percent exceeds the 

thresholds, call IRARMILE6 to enable or disable another 

processor. Otherwise, return to caller. 
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DIAGRAM SRM-21. IRARMIL6 - Modification of Processor 1/O Enablement (1 of 2) 


Input 





Register 1 


CsO 
CSDCPUAL 


~ CSDCPUVF 
CSDAXPAL 
aa ee 


PCCAVT 


aaa 
PCCAIS“E 


From CONFIGCH or ALTCPREC in 
SYSEVENT processor (IRARMEVT) 
or from selective enablement monitoring 
(IRARMILS) 


Process 


1 Find an online 
Processor whose 
enablement status 
can be changed. 


Change the enable- 
ment status in the 
PCCA and schedule 
an SRB to IOS to 
initiate the change. 


Return to caller 
(IRARMILS) 


IRARMSRV 


IRARMIO8 
Build and 
Schedule an 
SRB 


Output 


PCCA 


PCCAISCE 
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DIAGRAM SRM-21. IRARMIL6 - Modification of Processor I/O Enablement (2 of 2) 


Extended Description Module Label 


A change to the [/O enablement status of a processor 
is required for one of the following reasons: 


@ The selective enablement monitoring routine 
determined that the percentage of interruptions 
is not within the acceptable thresholds. 


e The CONFIGCH or ALTCPREC SYSEVENT indicates 
that an enabled processor is being taken offline. 


The search mask input parameter indicates whether a 
processor can be enabled or disabled. 


1 Using the CPU affinity mask and the search mask as IRARMIOM IRARMILS 
input, JRARMILG6 examines the PCAAs of each online 

processor to search for a processor with an 1/O enablement 

status that can be changed as required by the selective 

enablement monitoring routine (IRARMILS) or the 

CONFIGCH or ALTCPREC SYSEVENTSs. 


2 If it finds an eligible processor, IRARMIL6 changes the IRARMIOM IRARMILG6 
enablement state in PCCAISCE and passes control IRARMSRV IRARMIOS 

to IRARMIO8. IRARMIOS builds an SRB and schedules 

the SRB to 1OS. IRARMILE6 will choose the best candidate 

processors for 1/O Enablement based on processor type and 

address. For enablement, non-vector processors are pre- 

ferred over vector processors. 
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RARMCHM MODULE ENTRY POINT SUMMA 


TRARMCHF 
ITRARMCPF 


IRARMEDD 
IRARMEVD 


TRARMEVU 
ITRARMUPD 


IRARMMSP 


IRARMLPI 


LY28-1760-0 


MSCH cleanup. Free SRB, SCHIB, and IOSB storage. 


Measurement facility failure. Issue CHANNEL SYSEVENT when the channel 
reports an error in the measurement facility. 


DDR ENF exit. Issue DDR SYSEVENT when a swap command is issued. 


NA lat ENF exit. Issue UCBCHG SYSEVENT when a device is varied or 
oxed. 


Vary path ENF exit. Issue UCBCHG SYSEVENT when a path is varied. 


Channel Measurement Update Routine. Updete DMBs, LPBs, and CPMT if the 
associated facilities are active. If measurements are "START PENDING" 
and 16 seconds have elapsed, resume channel measurements. 


Channel Measurement Monitor Stop Routine. If device connect time 
interval (CDCTI) measurement is active but is not available, issue a 
message to the operator and mark the control block unavailable. If the 
CMB monitor facility 1s active, issue a SCHM to turn CMB measurements 
off. Write LOGREC entry with reason code 65F. Set the monitor active 
bit off and mark the DMB and the LPB device data as invalid. 


Channel Measurement Logical Path Block Index Routine. Calculate an LPB 
identifier from the channel path in the logical path mask of the UCB. 
Scan the LPBT for a match. If no match exists, build a new LPB at the 
end of the LPBT table. 
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DIAGRAM SRM-22. IRARMUPD - Channel Measurement Update Routine (1 of 4) 


Input 


CVT 
CVTOPCTP 


CMCT 


CMCTPAA 
CMCTMFOK 


CMCTPDMB 


CMCTCMBV 
CMCTCONN 
CMCTPEND 
CMCTACTV 
CMCTSAMP 





RMCT 





CMCT 


ae 
CMCTTDOMB 
CMCTCONN 





es 
RMCTCMCT 


RMCTWMST 


RMCTRMPT 





From algorithm processor (IRARMCEL) 
as a result of a request by periodic entry 
point scheduling (IRARMCET) Process 





RMCT 
RMCTCMCT 
RMCTICT 
_——_ | 9 1 Calculate channel path 
utilization rate. 
ICT 
eb i 2 Calculate logical path 
ICCLPBLO utilization rate. 
1EAOPT xx 


— 


L__J 


3 If channel measurement 


data collection is active 

or pending: 

a. Calculate the average 
pending time for the 
device. 








b. If 1/O load balancing is 
active, update temporary 
device measurement 
block (DMB) and collect 
data for each device. 
Store the percent 
connect time for each 
lagical path in the 
LPBT. 






RPMTIOC TW 


c 


Output 


CMCT 


Easy 






CMCTCPMT 

CMCTLPBT CMPTSAMB 
CMPTBUSB 
CMPTUTIL 


© 
be | 
i 
- 


CMCTPDMB 





LPBT 


LPBRVUF 
LPBCPUT 
LPBOUTIL 
LPBUUTIL 





DMB 
aes 


DMBDELTM 
DMBSAMPB 
DMBPENDB 
OMBCONNB 
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CMCT 


iors 
CMCTTDMB 
CMCTLPBT 

aaa 







DMB 
es 


OMBCONN 







eee] 
LPBCONNP 
an 
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DIAGRAM SRM-22. IRARMUPD - Channel Measurement Update Routine (2 of 4) 


Extended Description Module Label 


When channel measurement is active, the channel measure- IRARMCHM IRARMUPD 
ment routine, IRARMUPD, executes every 3 seconds to 
update SRM channel path measruements. 


1 The CMCTMFOK field indicates that the channel IRARMUPD CPMTVPDT 
measurement block (CMB) entries contain 

current data, and the CMCTPAA field indicates that 

channel path measurement is active. When these fields 

in the channel measurement control table (CMCT) 

are set, IRARMUPD processes the channel path 

measurement table (CPMT) and calculates the utilization 

rate for all online channel paths. If a channel path is 

not online, IRARMUPD s ‘s the utilization rate to 

a negative number. 


2  '!RARMUPD scans the logical path control block IRARMUPD LPBUPDT 
array and calculates the logical path utilization 

rate. [(RARMUPD compares the logical path utilization 

rate with the thresholds defined in IEAOPTxx to 

determine if the device is either overused or underused. 


3 


a. If channel measurement data collection is active 
(CMCTMFA = 1) or pending (CMCTMFSP = 1), IRARMUPD 
scans the permanent device measurement control blocks 
(DMBs) and collects data for each device. IRARMUPD cal- 
culates the average pending time for each device. Device 
measurement control blocks (DMBs) are either permanent 
or temporary. Device allocation uses permanent DMBs; 
[/O toad balancing uses temporary OMBs. 


b. If t/O load balancing is active, IRARMUPD 
scans the temporary DMBs and collects data for 
each device. IRARMUPD stores the percent 
connect time for each logical path in the 
logical path control block table (LBPT). 
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DIAGRAM SRM-22. IRARMUPD - Channel Measurement Update Routine (3 of 4) 


y 
Input Process 


@ If channel measurement 
CMCT data collection is pending ASCB 


and not active: 
CMCTCMBR 
a. Start device connect ASCBOUXB : 


time interval (DCT1) 





and channel measure- 
ment data collection. OUXBODCTI 
OUXBILS 
b. Issue an ENF signal | OUXBITD | 
for a measurement OUXBITD 
change TIRARMWMT | 
Service 
| CMCTMFOK | c. Call IRARMWM1 to update 
update address space routine 
service. 
ucB 
UCBMBI 5 If an unexpected zero 


UCBMBI index is 


encountered, stop IRARMMSP 


channel measurements. 





Return to algorithm processor 
(IRARMCEL) 
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DIAGRAM SRM-22. IRARMUPD - Channel Measurement Update Routine (4 of 4) 


Extended Description Module Label 
4 
a. if channel measurement data collection is pending IRARMUPD 


and not active (as long as no errors occurred during 
channel measurement initialization), IRARMUPD 
issues a set channel monitor instruction (SCHM) to 
start the device connect time interval (DCT!) and 
channel measurement data collection. 


b. IRARMUPD then issues 8. ENF signal to inform IRARMSRV 
listeners that the SRM chanrel measurements are 
active. IRARMUPD sets the CMB (CMCTMFA) 
and the DCTI (CMCTDCA) collection bits to 1. 


c. IRARMUPD calls IRARMWM1 to update service IRARMWM1 
for address spaces that have active transactions and 
to set base values for DCT! measurements. 


5 If an unexpected zero UCBMBI index is encountered, IRARMMSP 
{RARMUPD calls IRARMMSP to stop channel 
measurements. 
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DIAGRAM SRM-23. IRARMMSP - Channel Measurement Monitor Stop Routine (1 of 2) 


From SYSEVENT Processor, IRARMILO, 
IRARMERR, IRARMUPD 


Input Process 





1 Stop all measuring. 


RMCTCMCT 2 Issue an ENF signal to indicate 


thet measuring was stopped. 


ees 3 Indicate inactive status in 


control blocks. 


4 Request an SDUMP and 
write a LOGREC entry. 





Return to 
caller 





Output 


ABEND 65F 


LPBLBVAL 
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DIAGRAM SRM-23. IRARMMSP - Channel Measurement Monitor Stop Routine (2 of 2) 


Extended Description Module 


The channel measurement stop routine, IRARMMSP 
is invoked to terminate channel measurements. 


1 ‘Terminate channel measurement by turning off {RARMCHM 
CMCTMEA in the CMCT. !f device connect time 

measurement is active, it remains active. However, if 

the TOD clock is invalid or the channel measurement 

control blocks are invalid, terminate device connect 

time measurement by means of a set channel monitor 

instruction (SCHM). 


2 ~=iissue an ENF signal to inform listeners of a change IRARMSRV 
in the measurement status. A message is issued to 

the system programmer explaining why measurements 

were suspended. 


3 Update measurement control blocks to reflect the IRARMCHM 
inactive status, and terminate |/O load balancing. 

If the channel measurement Slocks (CMBs) contain 

valid data, terminate device all-cation evaluation and 

logical path use evaluation. 


4 If IRARMMS? is invoked because of an unexpected IRARMERR 
zero UCBMBI, a channel EXCP error, or insufficient IRARMCHM 

virtual storage, IRARMMSP produces an SDUMP with 

a 65F ABEND code and writes a LOGREC entry. 


Lebel 


IRARMMSP 


IRARMI11 


IRARMMSP 


IRARMMSP 
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DIAGRAM SRM-24. IRARMLPI - Measurement Logic Path Block Index Routine (1 of 2) 


From SYSEVENT processor 
(IRARMEVT) 


Input Process Output 





Register 1 


1. Determine the logical 
path block identifier and 
the channel path identi- 
fier array. 


2 Return the LEP offset 
or create a new LPB entry. 


Return to caller 
(IRARMEVT) 


LPBOFFST 
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DIAGRAM SRM-24. IRARMLPI - Measurement Logic Path Block Index Routine (2 of 2) 


Extended Description Module Label 


The channel measurement LPB index routine, IRARMLPI, IRARMCHM JIRARMLPI 
creates an LPB offset in the DMB when a DDR SYSEVENT 

(47) is issued or when a device is brought online or taken 

offline. 


1 The LPB offset routine scans all the channel path ids 

associated with a device, looking for valid channel 
path identifiers. IRARMLPI arranges the valid channel 
paths identifiers in ascending order in a channel path 
array. 


2 The LPB offset routine searches the logical path 

control block table (LPBT) looking for an LPB 
with a matching array. If no matching LPB exists, 
IRARMLPI builds a new LPB. The LPB offset is 
returned to the caller. 
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ARARMCPM MODULE ENTRY POINT SUMMARY 


ITRARMACT 


TRARMAP 1 


TRARMAP2 


IRARMEQ1 


TRARMCLO 


TRARMCL1 


ITRARMCL5 


IRARMSWT 


CHAP 


CPLRVSWF 


CPUWAIT 


CPUTLCK 


NEWDP 


LY28-1760-0 


Activate dispatching priority control. Examine user counts for time 
slice groups. Based on these counts, mark the time slice algorithm as 
active or inactive. 


Automatic priority group recorder processing. Recompute dispatching 
Priorities for all APG users in main storage. 


ASCBCHAP standard interface routine. Search the IN queue for APG users 
whose dispatching priority needs updating. 


ENQ/DE@Q@ algorithm ENQ time monitoring. Stop giving extra processor 
service to users with ENQHOLD SYSEVENTs outstanding who have already 
received their guaranteed processor service. 


CPU load balancing user swap processing. Compute user processor use 
profile at QSCECMP SYSEVENT. 


CPU utilization monitoring. Compute processor utilization variables for 
processor load balancing and resource management algorithms. Adjust 
workload skewing threshold. 


CPU load balancing user swap evaluation. Produce a numerical 
recommendation value that reflects the desirability of swapping user 
based on processor use. 


Switch to new dispatching priority control. Update the time slice 
tables to reflect a recent change in a specified user's dispatching 
priority control. 


IRARMCPM internal chapping subroutine. Build a parameter list and call 
ASCBCHAP. 


IRARMCPM internal wait factor computation subroutine. Compute system 
wait factor for processor load balancing recommendation value 
computation. 


IRARMCPM internal wait time and CPU utilization compute subroutine. 
Compute accumulated system wait time total for processors and compute 
recent processor utilization. 


IRARMCPM internal CPU utilization checking routine. Insure that the 
computed processor utilization percentage falls between 0 and 100 
percent. If it is 100 percent and any user has not been dispatched, set 
the percent to 101. If a ready, dispatchable address that should be on 
the dispatching queue is not, invoke a safety net check routine. 


IRARMCPM internal APG computation routine. Compute mean time to wait 
and new dispatching priorities for the APG user. 
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0-O92ZT-82A] +UBW S®Y SAS #71S YX/SAW 5ZT-WUS 


‘duod WAI #YBT4AdOD (2) 


L86T 





DIAGRAM SRM-25, IRARMCPM - CPU Management (1 of 8) 


From algorithm processor 
(IRARMCEL) as a result of 
a request by algorithm request 


Process 
CPU Management (IRARMCPM) 


1 Recompute the dispatching priorities 
for MTW users in the automatic 
priority group (APG), 


Schedule the invocation of AP2. 


IN queue 2 Interface with ASCBCHAP for 

header all users in real storage whose 
dispatching priorities need 
updating. 


IN queue 


rascaTnor_| - 








Output 
OUCB 
_— 
OUCBNDP 
OUCBTNDP 
RMCTALA 
Return to 
algorithm ASCB 
processor CHAP parm list! 
(IRARMCEL) 


ASCBs 
fe ed 


ASCBNTSG 


ASCBNDP 
ASCBTNDP 
ASCBDP 





IRARMSRV 


IRARMIO2 
change 


ASCBN 






dispatching 
priority 





RMCTALA 
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DIAGRAM SRM-25. IRARMCPM - CPU Management (2 of 8) 


Label 
Extended Description Module (or Segment) 


CPU management consists of a set of routines that monitor IRARMCPM 
the system-wide processor load. They recommend users for 
swapping when the system is underused or overused. 


Processor load balancing system profile adjustment is per- IRARMCPM IRARMCLO 
formed with the SRM receives a Q9CECMP SYSEVENT 
(OD). 


1. IRARMAPT1 searches for all users that are in real IRARMCPU =IRARMAP1 
storage whose dispatching priority places them in a NEWDP 

mean-time-to-wait group. AP1 then examines each user's 

execution time to ensure that the user has executed for 

more than a threshold value of time since the last 

computation. If the user has executed sufficient amount 

of time (CCAPMET), AP1 recalculates the base time slice 

dispatching priorities for the address space. The new 


priorities are calculated based on the user's mean-time- 


to-wait, that is, the average time the user was in execution 
before entering the wait state. The lower the mean-time- 
to wait, the higher the user’s priority within the mean-time- 
to-wait group. 


AP1 then schedules the execution of IRARMAP2 (see 
step 2). 


2 IRARMAP2 is the standard interface routine with IRARMCPU) IRARMAP2 
ASCBCHAP. A parameter list is built for every 

in-storage APG user whose current dispatching priority 

does not equal its new dispatching priority. IRARMIO2 is 

then invoked to interface with ASCBCHAP The invoca- IRARMSRV- IRARMIO2 

tion of IRARMACT is scheduled to ensure the timely 

activation or deactivation of time slicing (see step 8). 
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DIAGRAM SRM-25. IRARMCPM - CPU Management (3 of 8) 





Logical configuration 
communication area ‘ ne per 
processor) 

LCCAs 





Processor management 
control table 


CSDA 


CCT 


ey 
OUCBCRV 
= 


©) 


From user 
evaluation 
(IRARMCVL) 
during swap 


analysis 
(IRARMCAD) 





Process 


3 Monitor users previously given permission 
to accumulate extra processor service be- 
cause of their use of a serially reuseable 
(ENQ) resource. 


4 Revoke a user's permission to accumulate 
extra processor service, if he has accumu- 
lated a threshold amount of extra service, 





Return to 
algorithm 
processor 
(IRARMCEL) 





5 Compute the processor 
utilization variables, 


6 Compute a value representing the 
desirability of the swap-in or swap-out 
of a user, based on the user’s effect on 
system processor utilization. 


Return to user 
evaluation 
(IRARMCVL) 





cL 









Output 


8 


T 


CCVENQCT 


OUCBENQ 


OQ \e) 
Q 
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Processor utilization 
(CCVUTLIP) 


System wait 


factor 
(CCVRVSWF) 


OUCB 


Recommendation 
value 
(OUCBTCP) 


Time of 
evaluation 
(OUCBTCP) 








0-O9ZT-82A1 


‘d4og WAI FYBT4AdOD (9) 


L36T 


UoT}e49adg JO pouZoW 


LZT-WHS 


DIAGRAM SRM-25. IRARMCPM - CPU Management (4 of 8) 


Extended Description Module 


3. Auser is given permissic.. to accumulate extra pro- IRARMCPM 
cessor service when an ENQHOLD SYSEVENT (14) is 

received by the SRM, indicating that the user holds a critical 

resource. The mechanism for giving the user this extra 

service is the prevention of his swap out by the SRM 


because of service rate considerations. 


4 The enqueue residence value (ERV), an OPT IRARMCPM 
parameter, specifies the iength of the privileged 
spurt of service for a user for whom an ENQHOLD 
SYSEVENT (14) has been issued (see 3). When this 
time is exceeded, the user is made eligible for swap-out, 
and his OUCB is so flagged. The individual user 
evaluation routine is called to assign a current workload 


manager recommendation value to this user. 


(RARMWLM 


= The processor utilization is the average percentage (RARMCPM 
of time any processor in the system was not in 


the wait state. It is computed by the following formula: 


fceha= 460 = of wait routines on each processor) * 100 
(elapsed time since last entry) * (number of processors) 


Processor utilization is artifically set to 101% if actual 
utilization is 100% and one or more users have not 

been dispatched. This allows the processor to be con- 
sidered overused even if the processor threshold is 100%. 
The system wait factor is calculated for use in determining 
the swap recommendation value for a user (see step 6): 
it is a multiple of the square of the difference between a 
threshold value and the utilization, with the sign 
indicating the direction of the imbalance (overused or 
underused). If processor use falls between the high 

and low thresholds, the fector equals zero. 


Cc 


Label 
(or Segment) 


(RARMEQ1 


IRARMEQ!1 


IRARMWM3 


IRARMCL1 


CPUWAIT 
CPLRVSWF 


C 


Label 
Extended Description Module lor Segment) 
G The processor swap recommendation value for IRARMCPM IRARMCL3 
a significant processor user varies with the degree 
to which the processor load is out of balance. The 
recommendation value cannot be greater than one- 
fifth the highest workload level. For insignificant 
processor users, the recommendation value is zero. 
The time of this evaluation and the swap recommenda- |RARMCTL IRARMCVL 


tion are saved in the OUCB. The user swap evaluation 
routine, IRARMCVL, then multiplies the 
recommendation value by the processor resource 
factor coefficient (RMPTCPU) to produce the 

final CPM swap recommendation value. 
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DIAGRAM SRM-25. IRARMCPM - CPU Management (5 of 8) 


From action 
processor 
(IRARMCRN) 


Input Process Output 







eee ee 
ASCBNTSG 


ASCBNDP 
ASCBTNDP 









ASCBNTSG 



















ASCBNDP 











Update the time slice table 


to reflect a recent change in 
a user's dispatching priority control. 


7 






ane 
OUCBNTSG 





ASCBTNDP 















RMCTTSGT 
RMCTTSGE 


RMCT 


RMCTTSGT 
RMCTTSGE 

















Time slice 
group table 


TSGP1 
TSGP2 
TSGP16 
TSGPFF 












Return to caller 
of action. 










Time slice 
group table 






TSGP16 


TSGPFF 
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DIAGRAM SRM-25. IRARMCPM - CPU Management (6 of 8) 


Label 
Extended Description Module (or Segment) 
7 ‘This segment updates the time slice table to reflect IRARMCPM !IRARMSWT 


a recent change in this user’s dispatching control. 
The user counts for the old dispatching control are 
decreased and counts for the new control are increased. 
The new dispatching control indicator is moded from 
the OUCB to the ASCB. 
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Input 


RMCTTSGT 


RMCTTSGE 
RMCTTSAC 


RMCTRTAC 


DIAGRAM SRM-25. IRARMCPM - CPU Management (7 of 8) 


From algorithm processor 
(FRARMCEL) as a result 

of a request by algorithm 
request (IRARMCRL) 


Process 





Time slice table 


TSGP1 

TSGP2 
e 
e 
e 


TSGP16 


TSGPFF 





8 Examine user counts for time 
slice groups. Mark the time slice 
algorithm ACTIVE or INACTIVE 
based on these counts. 


Return to 
algorithm 
processor 
(IRARMCEL) 





Output 


RMCTTSAC 
RMCTRTAC 


RMCARTU 


RMCARTUS 
RMCATSU 


RMCATSG 
RMCAPRITN 
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DIAGRAM SRM-25. IRARMCPM - CPU Management (8 of 8) 


Label 
Extended Description Module (or Segment) 
8 Next, examine the user counts for each time slice IRARMCPM IRARMACT 


group. If any users are found to be in a time 
slice group, ensure time slicing is active. If no users 


are found, deactivate time slicing. 
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ITRARMRMR MODULE ENTRY POINT SUMMARY 


IRARMRM1 


IRARMRM2 


LY¥28-1760-0 


Resource monitor periodic monitoring. Accumulate several system 
resource contention indicators and the number of ready users for each 
domain at periodic sample intervals. 


Resource monitor MPL adjustment processing. Compute the average system 
resource utilization and determine if the system MPL should be raised 
or lowered. Adjust system maximum think time for demand swap. Ensure an 
adequate supply of double frame pairs on RSM's queue. For RIO domains, 
calculate the average elapsed time for TSO transactions ending in the 
first period. When enough samples have been accumulated, recalculate 
extended storage thresholds. 
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DIAGRAM SRM-26. IRARMRM1 - Resource Monitor Periodic Monitoring (1 of 2) 


From algorithm 


request (IRARMCEL) Process Output 


Input 


RCT 
De ee 


DMDTRUC 

















MCVSTCRI 


CCVUTILP 


ASMVT 


1 Sample the system and domain 
resource contention indicators. 

























ASMIORQR 
ASMSWROQR 









ASMIORQC 















ee 
DMDTCMPL 





Return to algorithm 
request (IRARMCEL) 




























ODMDTSOOU 
—<—<— | 


RCEAFC 






RCETOTFX 


RCEBELFX 


LSCT 
LSCTCNTW 
LSCTCNT 

cen 
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DIAGRAM SRM-26. IRARMRM1 - Resource Monitor Periodic Monitoring (2 of 2) 


Extended Description Module Label 


This routine is invoked at one second intervals and IRARMRMR IRARMRMI1 
accumulates: 


The highest system unreferenced frame interval 
count (MCVSTCRI}) 


The current processor utilization (CCVUTILP) 


The number of real storage frames available on the 
frame queue (RCEAFC) 


The number of uncompleted ASM requests for both 
swap and nonswap queues (ASM requests minus ASM 
completed requests) 


The number of fixed frames below 16 megabytes 
The total number of fixed frames 


The minimum number of available frames of extended MCVAECMN 
storage 
The number of ready users (the number of users on 


the ‘in’ queue plus the number of users of the ‘out’ 
queue) for each domain 


Additionally the maximum ready user count and the 
maximum in-storage user count since the last 
invocation of IRARMRM2 are calculated for each 
domain. 
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DIAGRAM SRM-27. IRARMRM2 - Resource Monitor MPL Adjustment Processing (1 of 4) 


From algorithm 
request (IRARMCEL) 


Process 


Input 






















Register 2 
1 Calculate the domain service for 

all in-storage users with a current 
transaction, 








RCVASMQS 
RCVAVQP 
RCVAVQC 
RCVVUICC 
RCVAFQC 
RCVASMQ 
RCVCTMC 


DMDT 
(eas 


DMDTRUC 


DMDTTRNT 
DMDTTRNC 


DMOTTWET 
ey 


















Compute by domain: 


e Domain contention 

@ The average ready users 

e@ The average service rate 

@ The average elapsed time for 
TSO transaction completing 

in the first period 







RCE 









RCEVIOP! 
HCEVIOPO 













RCESWPPO 





IRARMWLM 


IRARMWM!1 
update service 











Output 


RCT 


RCVAVQC 
RCVAVOP 
RCVASMQA 
RCVPTR 
RCVDPR 
RCVPAGRT 


RCVAFQA 
RCVNSQLA 
RCVFXCA 
RCVMFXA 
RCVTFXCA 
RCVF XiOoP 
RCVSWPTM 


av 
© 
< 
im =} 
~~ 


OMOT 


OMOTRUA 
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DIAGRAM SRM-27. IRARMRM2 - Resource Monitor MPL Adjustment Processing (2 of 4) 


Extended Description 


This routine is invoked at 106 SRM-second intervals. It pro- 
cesses the data accumulated by IRARMRM1 to compute 
the following: 


@ The average unreferenced frame interval count 
(RCVUICA) 


The average available frame queue count 


e@ The number of AVOLOWs over the last RM2 inter- 
val (RCVAVOC, for tracking only) 


@ The average percentage of storage below 16 mega- 
bytes that is fixed (RCVMF XA) 


@ The average percentage of all storage that is fixed 
or allocated for nonswap paging (RCVF XIOP) 


The average ASM queue length (RCVASMOA) 

The system page fault rate per second (RCVPTR) 

The system demand paging rate per second (RCVDPR) 
The system total paging rate per second (RCVPAGRT) 


The average time (in milliseconds) to process a non- 
swap paging request (RCVMSPP) 


@ The average time (in milliseconds) to process a swap 
Paging request (RCVSWPTM, for tracking only) 


If enough samples have accumulated, raise or lower the 
extended storage thresholds based on the percent of time 
that extended storage is exceeded. (RCEGROUP, 
RCEAECOK, RCEAECLO). 


@ The time weighted average number of ready users 
for each domain (DMDTRUA) 


@ The time weighted average service rate for each 
domain (DMDTTWSR) 


The time-weighted elapsed time for TSO transactions com- 
pleting in the first period is calculated for each RTO (re- 
sponse time objective) domain (DMDTTWET). 


The above system and domain -ontention factors are 
used to adjust the domain target MP Ls as follows: 


Module 


IRARMRMR 


Label Extended Description Maduse Lebel 


IRARMRM2 1 To ensure that domain service is up-to-date, IRARMWLM IRARMWM!1 
IRARMWM1 is called to update user service and to 
add the new increment to the appropriate domain. 


2 DMOTRUA is calculated to one hexadecimal place 
and is a weighted average of the current and old 
values. DMDTTWSR and DMDTTWET are similariy 


weighted averages. 
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Input 


DMDT 


DMDTRUA 






DMDTMPLT 





PoMoTHPLT 
Peet 
DMDTFWKL 
eee eee 
LSCTUCTH MCCOEEE’ 
LSCTMTEL 
LSCTMTEH | 
LSCTMETI 









LSCTMTED 
LSCTFETL 
LSCTFETH 
LSCTFTTL 
LSCTFTTH 
LSCTAFQL 
LSCTAFQH 


RCVUICA 
RCVAFQA 
RCVMFXA 


RCVFXIOP 
RCVMUSER 


DIAGRAM SRM-27. IRARMRM2 - Resource Monitor MPL Adjustment Processing (3 of 4) 


Process 


3 Compute the domain contention. 


4 Adjust the domain 
multiprogramming 
levels (MPLs) 


e Raise the MPL, 
e Lower the MPL. 


or 


e Equalize the MPL. 


5 If necessary, raise or lower 
the system maximum think 
time. 


6 if necessary, raise or lower 
the allocation of double 
frame pairs. 





Output 


IRARMSRV 


1 (Se 


Return to algorithm 
request (IRARMCEL) 


4 Minimum contention domain 


4 Makimum contention domain 


0 
= 
0 
— 


DMDTMPLT ‘ 


LSCTMTES 


tr” 
“” 
O 
| 
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DIAGRAM SRM-27. IRARMRM2 - Resource Monitor MPL Adjustment Processing (4 of 4) 


C 
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Extended Description Module Label Extended Description Module Label 
3 Each used domain contention index is computed “These default values effectively eliminate the corresponding conditions from 
by the formula: the comparison. 
average ready users x weight **x and y are processor dependent thresholds based on constants in 
max (current target MPL or one) iIRARMCPU. For example, the values for x and y on 168uUP are 
42 pages/second and 52 pages/second. 
This yields a measure of contention for this domain 
weighted by the user specified importance factor @ If any domain is unused (the average of the ready user 
(weight) for the domain and the highest ready user value less than target minus 
The tollowing vatues are used if an IPS specifying one) that domain’s MPL is decreased by one if the 
improved target adjustment is in control. decrease does not drop it below the minimum 
e For domains with AOBJ — workload level determined = IRARMWLM IRARMWMa MPL oF one. 
R 
by IRARMWM4 from DMOTTWSR. e@ If the system MPL should be raised, the resource monitor 
e With AOBJ — workload level from IRARMWM4 using selects the domain that has the highest contention 
DMDTTWSR divided by DMDTRUA. index and has not yet reached its maximum MPL and 
e With EWKL — use the value for EWKL. increases this domain's MPL by one. 
4 = The resource monitor will then determine if the Mt ms ee sei porns as Paani ipenesource 
system MPL should be raised or flowered by ieee i nae : eae saaeaaeas eee : ee 
comparing the system contention indicators against pre- aren: index w af d = seats peg pal aah 
defined limits (limits can be specified in the 1|EAOPTxx Sesh ye nee one 
parmlib member}. All positive conditions must be met to , 
increase the MPL and only one condition need be met to ey arenete ae Guarsman cuss eee oy Cocrene’: 
isicea decree the resource monitor attempts to equalize the domain’s 
contention index; such that if the highest domain 
DEFAULT LIMITS contention index is greater than the lowest, the 
INCREASE DECREASE resource monitor increases the MPL for the high 
MPL MPL contention domain and decreases the MPL for the 
UIC (unreferenced interval count) GT 4 LT 2 lowest contention domain. 
Processor utilization LT 98% GT 100.9% 
Page faults LT 1000/sec* GT 1000/sec* 5 The system maximum think time is adjusted for IRARMRMR !IRARMRM2 
ASMQ LT 100° requests GT 100° requests logical swap. This function is unrelated to mainline 
Demand passing LT ae ee GT tana MPL adjustment processing but must be performed at the 
(Processor utilization (Processor utilization sone nterwal 
no an ne porate i 6 Maintain RSM’s double frame queue to ensure IRARMRMR- [RARMRM2 
cess tim : 
100 milliseconds) Sele aa . nied supply of pairs to back the seeniactye -aacanas 
Fixed frames below 16 megabytes LT 82% GT 88% or 
Frames xed Orallocatedtonon- LT 66% GT 72% 7 sIf enough samples have accumulated, raise or lower the RCEGROUP 
swap paging 1/O extended storage thresholds based on the percent of RCEAECOK 


time that extended storage is completely allocated. 
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TRARMWLM MODULE ENTRY POINT SUMMARY 


TRARMWM1 


TRARMWM2 


TRARMWM5 


TRARMWM7 


IRARMWMI 


IRARMWMJ 


TRARMWMK 


IRARMWMN 


LY28-1760-0 


Workload manager service calculator routine. Calculates the amount of 
service provided to a user since the beginning of the current workload 
manager measurement interval for that user. Service is calculated 
using the following equation: Service =C(CMP)/K+C(CCT)/KtEI+(SB)/K 


where: 
= The MSO service coefficient scaled by 1/50. 

P = The number of page seconds (the product of the number of frames 

owned by the user and the amount of TCB time consumed) used 

by the user. 

The time required to execute 10,000 instructions. 

(Dependent on the processor model; 

The processor service coefficient. 

The job step time elapsed in the current interval. 

The I/0 service for this interval 

The I/0 service coefficient. 

The SRB time elapsed in the current interval. 

The SRB service coefficient. 


DUHMAO A 


This routine calculates each of the three service factors and the total 
service for the user for the interval. It also updates the domain 
service for the user and adds to the corresponding domain the service 
accumulated since IRARMWM1 was last called for this user. If the total 
service for the domain is likely to overflow the field, this routine 
calls IRARMWML to start a new transaction. 


Swappable user evaluation routine.Scans the IN Cin-storage) queue and 
the OUT Cout-of-storage-but-ready) queue, evaluates each swappable user 
and assigns each his current workload level. 


Workload manager update performance group period subroutine. Tests 
whether a user has accumulated enough service/’time to be assigned to a 
new performance group period. If so, IRARMWM5 adjusts the pointers that 
indicates the performance group period, performance objective, and 
domain applicable to the transaction current for the user. Note that 
the frequency Cresolution) at which the test period end is made depends 
on how often IRARMWM5 is called for any given user. 


WLM recommendation calculation routine. Calculates a workload manager 
recommendation value for a user based on the service received and on 
the performance objective currently associated with the user. Users 
that have not yet received an amount of service equal to their interval 
service value CISV) specification while in storage are given a 
recommendation value boost. The boost gives preferential treatment to 
rptagedionl their ISV as compared to users in their ISV and users between 
job steps. 


Workload manager in storage interval change subroutine. Updates the 
transaction accumulators with the service and the time received by the 
user during the preceding in-storage interval. 


Routine to determine the scope of applicability of analysis processing 
to a user. Examines the current swap status and the performance 
specification for a user. It indicates if the resource manager 
algorithms are applicable to this user. 


WLM dontswap/ okswap user analysis routine. Calculates the current 
service and ensures that the user is in the correct performance group 
period. Applicable algorithm indicators are set based on the new swap 
status of the user. 


Workload manager transaction start routine. The IRARMWMN routine 
receives control as the result of a SYSEVENT that has been defined by 
the workload manager to signify that a new transaction should be 
started for that user. If the user is not in storage, a flag is set to 
cause the IRARMWMN routine to be reentered during the swap-in of the 
user. Otherwise, any existing transaction is stopped by calling 
IRARMWMO, and the user transaction fields are reset to reflect the new 
transaction being started. 


Cc) Copyright IBM Corp. 1987 Method of Operation SRM-191 


IRARMWMO 


TRARMWMP 


TRARMWMGQ 


TRARMWMR 
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Workload manager transaction stop routine. The IRARMWMO routine 
receives control as the result of a SYSEVENT that has been specified by 
the workload manager as defining the end of any current user 
transaction. If a new transaction is to be created for the user, 
IRARMWMO indicates the end of the current transaction. If the next 
user event is not Known, IRARMWMO leaves the transaction accumulated 
values for later resumption of the transaction. In any case, IRARMWMO 
causes the preceding time and service to be properly recorded for the 
current transaction. 


Calculate page seconds routine. Calculates page seconds and page 
residency time for an address space. 


Workload manager quiesce completed SYSEVENT processing routine. The 
IRARMWMQ routine receives control when a user has stopped executing and 
1s being swapped out. The workload manager records the service given 
that user while he was in storage. The workload manager determines if a 
user event caused the swap-out, and flags the user to indicate whether 
such previous service is to be considered when the user is next 
swapped-in. 


Workload manager restore completed SYSEVENT processing routine. The 
IRARMWMR routine receives control when a user has been swapped in, and 
is ready to begin executing. The workload manager sets up the fields 
used to calculate the service rate the user is to receive during the 
forthcoming in-storage residency period. 
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ITRARMWLS MODULE ENTRY POINT SUMMARY 


TRARMHIT 


TRARMWML 


TRARMWMO 


IRARMWM3 


TRARMWM4 


TRARMWMS5 


IRARMWM? 


TRARMWM8 


IRARMWM9 


LY28-1760-0 


Workload manager user ready SYSEVENT swap-in scheduling keh ota 
Receives control as the result of a decision to apply swap-i 

processing to a ready user. It repositions the ready user fron the WAIT 
queue to the OUT queue. For a TSO user controlled by the RTO parameter, 
IRARMHIT determines whether or not to delay the transaction and how 
long the delay should be. 


Restart long running transaction routine. Starts a new transaction for 
an address space whose service totals may overflow the fields where 
they are stored. 


Workload manager service calculator routine. Calculates the amount of 
service used by a transaction or set of transactions. This routine is 
called by IRARMWM8 Cupdate processing for subsystem transaction 
reporting). IRARMWMO performs the same function as IRARMWM1 except it 
uses a TRQE as input and an RSPL as output. 


Individual user evaluation routine. Evaluates a swappable user on the 
IN or OUT queue and assigns a current workload level. 


Workload manager workload level calculator subroutine. Accepts a 
service rate, performance objective, and calculates the corresponding 
workload level. 


Workload manager update performance group period subroutine. Tests 
whether a user has accumulated enough service/time to be assigned to a 
new performance group period. If so, IRARMWM5 adjusts the pointers that 
indicates the performance group period, performance objective, and 
domain applicable to the transaction current for the user. Note that 
the frequency Cresolution) at which the test period end is made depends 
on how often IRARMWM5 is called for any given user. 


WLM recommendation calculation routine. Calculates a workload manager 
recommendation value for a user based on the service received and on 
the performance objective currently associated with the user. Users 
that have not yet received an amount of service equal to their interval 
service value CISV) specification while in storage are given a 
recommendation value boost. The boost gives preferential treatment to 
pte their ISV as compared to users in their ISV and users between 
job steps. 


Transaction reporting queue storage control and data update algorithm. 
Obtains and releases storage as necessary for transaction reporting 
queue elements. At timed intervals, it reports service values for any 
queue elements on the update queues and returns the elements to the 
available queues. The elements are put on the update queues by the 
transaction reporting SYSEVENT CSYSEVENT 35, 36, and 37). 


CAlias of IRARMW8) Transaction reporting queue storage control and data 
update algorithm. Performs the same function as IRARMWM8. The IRARMWM9 
alias is used when the function is called as a subroutine (for example, 
by SET command processing). 
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DIAGRAM SRM-28. IRARMWM2 - Swappablie User Evaluation (1 of 4) 


From algorithm request 


Input routine (IRARMCEL). Process 












specification table ~.— 
N | WMST 
OUCB 


OUXBPSS 
OUXBMSS 
OUXBIOS 
















ASCBEJST 
ASCBIOSM 
ASCBSRBT 





WPGLDUR 
WPGPAPGV 
WPGPDOMN 







OUXB 


OUXBPRS 







OUCBWMS 
OUCBTMP 
OUCBDMN 
OUCBAPG 








1 Calculate the page seconds for 


2 Obtain the user service. Add it 
to the appropriate domain 


service (IRARMWM1). 


3 Check for performance 
group period change 
(IRARMWMS). 
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DIAGRAM SRM-28. IRARMWM2 - Swappable User Evaluation (2 of 4) 


Extended Description Module Lebel 


The IRARMWM2 routine is invoked by the periodic entry 
point scheduler, via IRARMCEL (the algorithm request 
routine) approximately every SRM second (that Is, one 
second adjusted according to processor speed) to 
calculate the page seconds. If a user has gone a minimum 
of three SRM seconds on or. real second without being 
evaluated, the user is evaluate. 


1 IRARMWN2 scans both the IN and OUT queues IRARMWLM IRARMWM2 
and calculates the page seconds (the product of 

the number of frames owned by the user and the 

amount of TCB time consumed) for each user. 


2  WM1 is invoked to calculate the service IRARMWLM IRARMWM1 
accumulated during the in-real-storage interval 

for users currently in storage. The service accumulated 

since the last invocation of IRARMWM1 for this user 

is added to the corresponding domain’s service. 


3 Depending on the uni* code in the IPS (service IRARMWLM IRARMWMS5 
units or time units), the transaction’s accumulated 

service or time units are checked to determine whether 

a period has ended. If a period has ended, the current 

period indication is updated. If workload reporting is 

also active, IRARMWRG4 is invoked to communicate IRARMWAR (IRARMWR4 

the period change. If, in switching period, the user 

also changes domains, the user is repositioned at the 

end of the appropriate ques. The user dispatching IRARMCTL IRARMRPS 

Priority is also updated, if applicable. 
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DIAGRAM SRM-28. IRARMWM2 - Swappable User Evaluation (3 of 4) 


input Process Output 






Performance 






























wPGD 
group 
Ree dba 4 Determine the workload 

Performance level at which this user is OUCBWMA 
OUCB objective receiving service OQUCBTMA 


(IRARMWM?7). 






OUCBTMW 





5 Obtain the next user for 
evaluation. 


Go to 
step 1 






Return to algorithm 
routine ((RARMCRT) 
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DIAGRAM SRM-28. IRARMWM2 - Swappable User Evaluation (4 of 4) 


Extended Description 


4 The workload level is a means of comparing users 


to other users in the same domain. {f a user has 
not yet received enough service to be controlied by the 
workload manager (that is, his service is less than his 
interval service value-ISV) or if the user is between job 
steps, 8 workload level corresponding to a zero service 
rate is returned. in calculating his recent service rate, 
a user's accumulated service is reset to zero when he is 
swapped in; his accumulated time is reset to zero when 
he is swapped-out. This accumulated time is saved in 
the OUCBTMA field of the OUCB. 


5 = Processing continues until all users on the IN and 
OUT queues are evaluated. 


Module Label 


IRARMWLM (IRARMWM7 
IRARMWM4 
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DIAGRAM SRM-29. IRARMWMS - Individual User Evaluation (1 of 2) 


From user 
evaluation (IRARMCVL) Process 


i 







1 Obtain the user service 








(IRARMWM1). 
ASCBEJST 
ASCBIOSM 
OUXBIOS 
OUXBIOSM OUXB 
OUXBPRS 
Performance OUCB 
group description OUCBWMS OUCBPGP 
OUCBTMP 2 Check for a performance group OUCBDMN 


OUCBDMO 
OUCBNDP 
OUCBTMP 


WwPGD OUCBDMN 


period change (IRARWM8). 
WPGLDUR OUCBAPG 





WPGPAPGV 
WPGPDMN 





OUXBPRS 









Performance OUCB 


oup description 
er y OUCBWMS 
OUCBTMW 


Performance 
WPGLISV objective 





OUCBWMR 


i kload level at 
3 Determine the workload level a OUCBTMA 


which this user is receiving service 


WPGD (IRARMWM7). 






Return to user 
evaluation (IRARMCVL) 
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DIAGRAM SRM-29. IRARMWMs3 - Individual User Evaluation (2 of 2) 


Extended Description Module Label 


The IRARMWM3 routine is invoked by the user evaluation 
routine (IRARMCVL) during analysis of users in a 
particular domain. The major output of the routine is 

the workload level (recommendation value) of the user 
being evaluated. Non-swappable and privileged users 

are not evaluated. 


1. WM 1 is invoked to calculate the service IRARMWLM IRARMWM1 
accumulated during the in-real-storage interval 
for users currently in storage. 


2 Depending on the units code in the IPS (service IRARMWLM IRARMWM5 
units Or time units), the transaction’s 

accumulated service or time units is checked to 

determine whether a period has ended. If a period has 

ended, the current period indication is updated. If 

workload reporting is also active, IRARMWR4 is IRARMWAR IRARMWR4 

invoked to communicate the period change. If, in 

switching periods, the user also changes domains, the 

user is repositioned at the end of the appropriate queue. 

The user dispatching priority is also updated, if applicable. “IRARMCTL !IRARMRPS 


3 The workload level is a means of comparing IRARMWLM |tRARMWM7 
users to other users in the same domain. If a IRARMWM4 

user has not yet received enough service to be 

controlled by the workload manager (that is, the 

service is less than the interval service value-ISV) 

or if the user is between job steps, a workload level 

corresponding to a zero service rate is returned. 

In calculating a user's recent service rate, a user's 

accumulated service is reset to zero when swapped-in; 

the user’s accumulated time is reset to zero when 

swapped-in; the user’s accumulated time is reset 

to zero when the user is swapped-out. This 

accumulated time is saved in the OUCBTMA field 

of the OUCB. 
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DIAGRAM SRM-30. IRARMHIT - User Ready Processing (1 of 2) 


From control routing routine 
(IRARMCRT, IRARMCRN, or IRARMCRY) 


input Process Output 


Performance 


group 
descriptor 


OUCB 









OUXB 


OUXBPRS 


OUCB 



















WPGLDUR 
WPGPAPGV 
WPGPDMN 






















OUCBWMS OUXB 1 Check for a performance group OUCBPGP 
Buca period change (JIRARMWM65). OUCBDMN 


OUCBDMO 
OUCBNDP 
OUCBTMP 


OUXBPRS 


OUCBPVL OUCBTRM 
OUCBENQ OUCBCIM 
OUCBINC OUCBINC 
OUCBATR 


OUCBAPG 





2 Reset the transaction indicators. OUCBOFF OUCBTMW 


OUCBSTR OUCBWMR 
OUCBNTR OUCBTMA 
OUCBPGP OUCBNDP 
OUCBDMN OUCBTNDP 
OUCBDMO OUCBNTSG 


OUCBTMP OU Pp 
3 Delay the transaction for a TSO Sucre CBDSPN 


user controlled by the RTO pa- 
rameter, if necessary. 


OMDT RRPA 








WPGLRTO 


WPGDRTOF 


OUCBDLYD 
OUCBDLYT 


4 Make the user eligible for swap-in. 


RMCTOUTQ 


& Request SRM analysis to 
expedite the swap-in (IRARMCAP). 


Ready user 
OUCB on 
OUT queue 


Ready user 
OUCB on 
wait queue 






Return to control routine 
(IRARMCRT, [RARMCRN, 
or TRARMCRY) 
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DIAGRAM SRM-30. IRARMHIT - User Ready Processing (2 of 2) 


Extended Description Module Label 


IRARMHIT is requested by IRARMEVT when it receives IRARMWLS IRARMHIT 4 


a user ready SYSEVENT (04) from the dispatcher. The 
major function of this routine is to make users eligible 
for swap-in by repositioning them from the WAIT 
queue to the OUT queue. 


1. Depending on the units code in the IPS (service IRARMWLM IRARMWM5 
units or time units), the transaction’s accumulated 

service or time units are checked to determine whether 

a period has ended. If a period has ended, the current 

period indication is updated. If workload reporting is 

also active, IRARMWR4 is invoked to communicate IRARMWAR IRARMWR4 

the period change. If, in switching periods, the user 

also changes domains, the user is repositioned at the 

end of the appropriate queue. The user dispatching IRARMCTL IRARMRPS 

priority is also updated, if applicable. 


2 ~=siThe transaction indicators are reset based on the 
type of user and the user's transaction status 
when swapped-out. That is: 


a) OUCBs for users between job steps remain 
effectively unchanged. 


b) OUCBs for terminal wait users are updated 
to reflect the start of a transaction. indicators are 
set to the first period characteristics. 


A workload level is assigned which is equal to the IRARMWLM IRARMWM4 
first period objective “zero point’’. 
c) OUCBs for users that have suspended transactions 


(may be due to issuing “long wait’) are updated so 
that they look as if the swap-out had just ended. 


3 sf the response time objective (RTO) parameter is IRARMWLM IRARMHIT 
coded in the IPS for this TSO user and the user 

becomes ready following a terminal input wait, IRARMHIT 

delays the swap-in of the user such that the elapsed time 

of a first period TSO transaction equals the RTO. The 

amount of time to delay this user is computed based on a 

time-weighted average maintained in the domain descriptor 

table (DMDT) for the applicable domain. It is the average 

of the non-delay elapsed time for TSO transactions ending 

in the first period in that domain. The statistics for this IRARMWMO 

average are collected when a transaction ends. The average IntAnMRMR IRARMRM2 

is computed by IRARMRMN2 at timed intervals. 


5 


Extended Description 


The ‘‘ready’’ user OUCB is repositioned from the 
WAIT queue to the end of the OUT queue. 


The SRM analysis function is requested in order 
to have the user swapped in as soon as possibile. 


Module 


IRARMCTL 


IRARMCTL 


C 


Label 


IRARMRPS 


IRARMCAP 
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DIAGRAM SRM-31. IRARMWM8 - Transaction Reporting Algorithm (1 of 4) 


From IRARMCEL, IRARMWR1, 
IRARME47, IRARMWRB 


0-O09ZT-82A1 #WBW SeY SAG :71S YX/SAW 202-WHYS 


‘dod WAI PYBT4AdOD (9) 


L86T 


Input 


RMCTNOBQ 
RMCTNOEQ 


RMCTTRAD 





RMCTTRPC 


RMCT ~RQE’s 


RMCTUPDQ 


Installation control 
specification tables 


| 


a) 


Process 


1 


if the basic or extended queue 
is empty, obtain additional 
Queue storage. 


Dequeue an element from the 
update queue and obtain per- 
formance group numbers from 
the installation control 
specification. 





IRARMFPG 


Output 


ares 
RSPLCPGN 


RSPLSRPG 


RSPLNRPG 
RSPLURPG 
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DIAGRAM SRM-31. IRARMWMS - Transaction Reporting Algorithm (2 of 4) 


Extended Description Module Label 


This routine provides algorithm processing for subsystem IRARMWLS. IRARMWMS 
transaction reporting. IRARMWM6B is called by 

IRARMCEL (timed algorithm scheduling routine) at 

processor-dependent intervals. it is called using the alias 

IRARMWMS by IRARMWR1 (workload initialization), 

IRARMWR3 (workload collection), IRARME47 (work- 

loud termination) and IRARMWR8S (set processing). 

IRARMWMS processes data sccumulated on the trans- 

action update queue. The data is added to the appro- 

priate WAMP entry in the RMF workload activity 


measurement table (WAMT). 
1. Transaction reporting SYSEVENTs (TRAXRPT and 


TRAXFRPT) place data in elements from the basic 
queue, Extended transaction reporting SYSEVENTs 
(TRAXERPT) place data in elements from the extended 
queue. Both types are then placed on the update queue. 

If no queue elements are available for use by a SYSEVENT, 
one of two bits is set in the RMCT (RMCTNOBO or 
RMCTNOEQ) which signals IRARMWMBS to obtain more 
storage. This storage is partitioned into queue elements 

and chained to the appropriate queue (basic or extended). 


2 IRARMWM6& serially processes each element on the IRARMFPG (RARMFPG 
update queue (steps 2 through 5) until the update 

queue is empty. IRARMWMB then calls IRARMFPG 

tu assign one or more report performance gruups using 

the transaction data (subsystem name, transaction name, 

transaction class and user ID). 
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W&I $0 Ajvadodd — STeTUSeW pesusoti 


0-O9ZT-82A1 +WBW Sey SAS *71S VX/SAN 402-WUS 


"duog WAI }#YBTYAdOD (9) 


L861 


DIAGRAM SRM-31. IRARMWM58 - Transaction Reporting Algorithm (3 of 4) 


input 


RMCT TRQE 













RMCTUPDQ 


WMST 


a eT 
WMSTCPU 
WMSTSRB 
WMSTMSD 


WMSTIOC 
en eae 






TRQEEXTN 








Process 


3 Calculate the service values 
for an extended queue element. 


IRARMWMO 


4 Add the transaction and 
service data to the WAMT. 


IRARMWR9 


5 Return the queue element to 
the appropriate queue. 


lf there are more 
elements to process Step 2 


Return to the caller 





re 


Output 


RSPLTOTS 
RSPLCPUS 
RSPLIOCS 


RSPLMSOS 
RSPLSRBS 


fe te ee 
RMCTBRQE 


RMCTERQE 
faa, ty 
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DIAGRAM SRM-31. IRARMWM68 - Transaction Reporting Algorithm (4 of 4) 


Extended Description Module Label 


3 Extended queue elements contain service statistics. IRARMWLS IRARMWMO 
IRARMWM68 uses this data to calculate the service 

rate for the transaction based on the service coefficients 

in the workload manager specification table (WMST). 


4 IRARMWM8 adds the elapsed time for the trans- IRARMWAR IRARMWR9 
action, the elapsed time squared, and the service 

data to the WAMP entry of the WAMT that corresponds 

to the report performance group obtained in step 2. 


5 = This routine returns the element to the appropriate 

queue and continues processing at step 2 if there 
are more elements to process, otherwise control is 
returned to the caller. 
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IRARMWAR MODULE ENTRY POINT SUMMARY 


ITRARMWR1 


TRARMWR2 


TRARMWR3 


TRARMWR4 


TRARMWRS5 


TRARMWR6 


TRARMWR7 


ITRARMWR8 


TRARMWR9 


TRARMWRA 


LY28-1760-0 


Workload activity recording initialization subroutine. Constructs and 
initializes the workload activity measurement table CWAMT) in the 
buffer (storage from SQA) obtained by RMF. 


Workload activity recording WAMT initialization subroutine. Builds the 
WAMT in a format suitable for updating by the SRM. 


SRM workload activity recording data collection subroutine. Moves the 
contents of the WAMT into a collection buffer capable of containing the 
data. Note: The buffer is obtained by RMF from LSQA, storage key 0, 
and must be fixed in storage. 


If the IPS has not been changed, then adds to the collected data the 
transaction data for the current in-storage interval for each 
in-storage address space with an active transaction, re-initializes the 
data collection buffer for the next collection interval, and calculates 
the workload level for each performance group period that contains 
transaction data. 


SRM workload activity recording transaction data update subroutine. 
Adds the service and transaction active time to the appropriate WAMT 
performance group period accumulator in the data collection interval. 


SRM workload activity recording workload level calculation subroutine. 
Calculates the workload level for each WAMT performance group period 
entry in which transaction data has been accumulated during the last 
data collection interval. 


Note: For those WAMT entries in which the calculated service rate can 
be associated with multiple workload levels or is zero even though at 
least one transaction has been active during the data collection 
interval, the negative value of the workload level will be calculated 
to indicated an estimated value to RMF. 


SRM workload activity recording transaction end update subroutine. 
Adds to the appropriate WAMT performance group period accumulator the 
transaction elapsed time and counts the number of transactions that 
terminated during the current data collection interval. 


SRM workload activity recording WAMT entry determination subroutine. 
Obtains addressability to the WAMT performance group period entry in 
which to accumulate user transaction information. 


SRM workload activity recording. Terminates workload activity data 
collection whenever an IPS change occurs. 


Symbolic workload recording processor. Called by IJRARMWM8 each time an 
extended TRQE is processed. It adds service data to the WAMT for RMF. 


Symbolic performance recording. Constructs the ICSM (in a format that 


workload activity recording can reference) for symbolic performance 
recording. 
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DIAGRAM SRM-32. IRARMWR1I - Initialize for RMF (1 of 2) 


From SYSEVENT processor 


input (IRARMEVT) (SYSEVENT 2D) Process 


Register 6 Initialize The WAMT 
(IRARMWR1) 


1 Update the header. 


Workload 2 
manager 

specification 

table 


Build the index structure 
and initialize the buffer 
(call IRARMWR 2). 


3 Update the period service 





values (call IRARMWM1). 


To SYSEVENT processor 
(IRARMEVT) 


Output 


Register 6 


ae 
WAMPDMN 


WAMPOBJ 
WAMPSRV 


group Period 
WAMPOBJ entries 


WAMPSRV (WAMPs) 
se ef ee 


Lif 


Register 15 
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DIAGRAM SRM-32. IRARMWRI - Initialize for RMF (2 of 2) 


Extended Description Module Label 


IRARMWR1 constructs and initializes the workload IRARMWAR IRARMWRI1 
activity measurement table (WAMT) in the buffer 

(storage from SQA) obtained by AMF and input with 

Sysevent 2D. 


2 The index is used to locate the period entries in IRARMWAR IRARMWR2 
WAMT that correspond to a particular 

performance group. The period entries are updated 

with their respective domain and performance 

objective numbers. All other period entry values are 

zeroed. 


3 Service values in the period entries are initialized IRARMWLM IRARMWM1 
such that service already received by active user 

transactions is not included in the RMF interval service 

totals. 

Return Codes in Register 15 byte 3 

X'00’ — Data area accepted and initialized. 


X‘08’ — Length of data area incorrect. 
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DIAGRAM SRM-33. IRARMRW3 - Collect Data for RMF (1 of 2) 


From SYSEVENT processor IRARMEVT 
Input (SYSEVENT 2E) Process Output 


RRPAINP 
Register 6 Collect Data Recorded In 


WAMT (IRARMWR3) Buffer area 


1 Copy the WAMT to the provided 


area. 
WAMT 


Register 6 


RRPAINP 


Buffer 
area 


2 Reinitialize the WAMT 


(call IRARMWR2). Performance 


group period 
entries 


3 Update the period service (WAMPs) 


values (call IRARMWM1). 





RRPAINP 


4 Calculate the workload level 
for each period ; 
(cali IRARMWRS5). Period 


entries 


WaI $0 AjZdedOdd — STeTWACEW PESuasty 


wW@I JO STEFUSIEW PazdT4zSeY,, 


WAMPSRV+WAMPWLL 


Register 15 


To SYSEVENT 


processor (IRARMEVT) 
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DIAGRAM SRM-33. IRARMRWS3 - Collect Data for RMF (2 of 2) 
Extended Description Module 


IRARMWR3 copies the contents of the WAMT into a IRARMWAR 
collection buffer. The buffer is obtained by the 
measurement facility from LSQA and is fixed in storage. 


1. The WAMT is copied into the buffer. 


2 iif. aset to a new IPS occurs, workload collection 
is terminated and the WAMT is updated to 
reflect the statistics at that point in time. If the tRARMWAR 
IPS has not been changed, the WAMT is updated for 
@ new collection interval. 


3 Both the WAMT and the collection buffer are IRARMWLM 
updated to reflect the actual service (SRV) 
received within each respective interval. 


4 ~The workload levels (WLL) are updated in the IRARMWAR 
collection buffer for the measurement facility. 


Return codes in Register 15 byte 3 
X‘00’ — Successfu! data collection 


X’O4' — Successful data collection, but an IPS 
change occurred terminating workload 
collection 


X‘40’ — Data collection is not active, or the data buffer 
is Non-existent, or the copy of the buffer is an 
incorrect size. 


C 


Label 


IRARMWR3 


IRARMWR2 
iRARMWM1 


'(RARMWRS5 
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ARMCB ODU RY POT SU 
IRARMCBS SRM status for the address space represented 
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DIAGRAM SRM-34. IRARMCBS - SRM Control Block Status Exit (1 of 5) 
IRARMCBS = MODULE DESCRIPTION 


DESCRIPTIVE NAME: SRM Control Block Status Exit. 


FUNCTION: 
Analyzes an OUCB (SRM User control block) to give 
SRM status for the address space that it represents 


ENTRY POINT: IRARMCEBS 

PURPOSE: See FUNCTION 

LINKAGE: None 

CALLERS: BLSACBSS (Through exit services router) 


INPUT : 
Two parameters are passed: 


ZZ2 - The IPCS task variable. Contains parameters 
that are passed on to the IPCS routines. 


CBSP - The Control Block Status Parameter List. This 
contains information about the ASCB which has 
been accessed that contains the address of the 
OUCB that's to be tested here. 


OUTPUT: One or more messages, see MESSAGES, below. 
EXIT NORMAL: 
EXTERNAL REFERENCES: 


ROUTINES: 

BLSRACCQ -- IPCS dump access service. Used to 
obtain a copy of a control block in the 
dump. This version specifies that the 
dump routine should print messages if 
it fails to access the control block. 
Called indirectly through ADPLESRV. 


BLSRACCN 


IPCS dump access service. Used to 
access a single field within a control 
block instead of the whole thing. 


BLSUPPR2Z 


- IPCS expanded print service. Used 
to print the messages. Called 
indirectly through ADPLESRV. 


ADPLESRV -- IPCS exit services router. 


IRARMCBV -- OUCB control block validity check 
routine. Called indirectly through 
the ?BLSRESSA service. 


CONTROL BLOCKS; 
ASCB -- Address Space Control Block 
ESR -- Equate Symbol Record 
CBSP -- Control Block Status Parameter List 
OUCB -- SRM User Request Block 
RMQH -- SRM Queue Header Block 
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DIAGRAM SRM-34,. IRARMCBS - SRM Control Block Status Exit (2 of 5) 
IRARMCBS - MODULE OPERATION 


The IPCS OUCB validity check routine is called 
to determine whether the OUCB pointed to by 
the ASCB that was passed as input in a buffer 
is valid. The OUCB contains SRM information 
pertaining to an address space to be analyzed. 


If the OUCB is valid, it is obtained through a 
call to the IPCS dump access service. If, 
however, the validity check routine returned a 
code indicating that the OUCB was damaged 
seriously enough to prevent further processing» 
message IRA10101I is generated. 


The OUCB is on one of four circular 
double-threaded, single-headed queues, one for 
each possible state of an address space: IN, OUT; 
WAIT, or LOGICAL SWAP WAIT. For each of these 
queues, a pointer in the RMCT points to a 
Resources Manager Queue Header (RMQH). This is a 
block that is chained into the queue with the 
OUCB's and contains a field -- RMQHNAME -- which 
identifies the queue. 


Message IRA10102I states which queue the OUCB is 
on, if it can be determined. In order to 

determine which queue the OUCB is on,» a chain of 
OUCB's is followed to its anchor block, the RMQH. 


If this analysis routine encounters some 
difficulty in following the forward pointers 
(OUCBFWD) through the OUCB chain (in the form of a 
circular queue or an OUCB that cannot be 
accessed), the backward pointers are followed. 


If the backward search fails (for similar 
reasons), then if the OUCB was not ina 
transitioning state (OUCBGOB = 0, OUCBGOI = 0, 
and OUCBGOO = 0) message 

IRA10112I is generated to give the OUCB's status 
according to queue indicator bits in the block 
(OUCBOUT, OUCBOFF, and OUCBLSW). 


If, when the search fails, OUCBGOB, OUCBGOO, 

or OUCBGOI indicate that 

the address space was transitioning (meaning that 
bits OUCBOFF, OUCBOUT, and OUCBLSW give the 
destination queue, not the present one), message 
IRA10114I is generated to say that the queue 
identity cannot be determined. This message 
appears before any messages describing how this 
routine failed to follow the queue or read the 
RMQHNAME field. 


If the OUCB queue was determined successfully, and 
the address space was not transitioning» and the 
bits in the OUCB indicate a queue that's different 
from the one the OUCB was found on» message 
IRA10113I is generated. 


If the address space represented by the OUCB is 
transitioning to another queue, IRA10103I states 
which it's moving to. 

If the address space is swapped out or in the 
process of being swapped out, message IRA10104I is 
generated to give the reason for swap-out. 


If the address space is in the process of being 


LY28-1760-0 (c) Copyright IBM Corp. 1987 Method of Operation SRM-215 





"Restricted Materials of IBM" 
Licensed Materials —~ Property of IBM 


DIAGRAM SRM-34. IRARMCBS - SRM Control Block Status Exit (3 of 5) ) 


ITRARMCBS - MODULE OPERATION § (Continued) 


swapped out, message IRALOL1OSI gives the last 
process started. 


If the address space has issued a DONTSWAP 
SYSEVENT followed by a TRANSWAP SYSEVENT, message 
IRALO1O6I states that it is waiting completion of 
a DONTSWAP/OKSWAP sequence. 


The highest code returned from an IPCS access 
routine called here is returned from this module. 


RECOVERY OPERATION: Covered by the IPCS ESTAE 
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DIAGRAM SRM-34. IRARMCBS - SRM Control Block Status Exit (4 of 5) 
IRARMCBS - DIAGNOSTIC AIDS 


ENTRY POINT NAME: IRARMCBS 


MESSAGES: 


The following messages may be generated (via the BLSUPPR2 
exit service): 


IRA10101I Unable to produce SRM analysis for this address 
space. 


IRA10102I This address space is on the SRM xxx queue 
where xxx is IN, OUT, LOGICAL SWAP WAIT or WAIT 


IRA10103I It is moving to the SRM xxx queue 
where xxx is IN, OUT, LOGICAL SWAP WAIT or WAIT 


IRA10104I The reason for swap-out is yyy 
where yyy is text associated with this swap out reason code: 
input terminal wait (1). 
output terminal wait (2). 
long wait (3). 
auxiliary storage shortage (4). 
real pageable storage shortage (5). 
detected wait (6). 
requested swap (7). 
enqueue exchange (8). 
exchange on recommendation value (9). 
unilateral swap (10). 
transition to nonswappable (11). 


IRA1O105I In the swap-out process, zzz 
where zzz is the current state of the swap-out process: 
RCT has been posted. 
QUIESCE has started. 
QUIESCE has completed. 
QUIESCE has failed. 


IRA10106I A TRANSWAP SYSEVENT is waiting for completion of a 
DONTSWAP/OKSWAP sequence. 


IRA10107I The OUCB for this address space is on a queue whose 
anchor block has a queue name that does not contain a valid 
value. 


IRA10108I The OUCB for this address space is on an SRM queue 
with a forward pointer that is not valid. 


IRA10109I The OUCB for this address space is on an SRM queue 
with a circular forward loop. 


IRA10110I The OUCB for this address space is on an SRM queue 
with a backward pointer that is not valid. 


IRA1O111I The OUCB for this address space is on an SRM queue 
with a circular backward loop. 


IRA10112I According to the fields OUCBOUT, OUCBOFF, and OUCBLSH, 
this address space is on the SRM xxx queue. 


IRA10113I The fields in the OUCB: OUCBOUT, OUCBOFF, and OUCBLSNW 
indicate that this address space is on the SRM xxx queues 
however, the address space is on the SRM yyy queue. 


IRA10114I Unable to determine the identity of the SRM queue for 
this address space. 
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DIAGRAM SRM-34. IRARMCBS - SRM Control Block Status Exit (5S of 5) 
IRARMCBS = DIAGNOSTIC AIDS (Continued) 


ABEND CODES: None 


WAIT STATE CODES: None 


RETURN CODES: 
EXIT NORMAL: 
Register 15 contains zero on return if the 
the routine completed successfully and has 
generated status. 
EXIT ERROR: 
Register 15 contains the highest return code set by a 
failing service. 


REGISTER CONTENTS ON ENTRY: 
Standard Entry 


REGISTER CONTENTS ON EXIT: 
EXIT NORMAL: 

Standard Exit 
EXIT ERROR: 

Standard Exit 
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action/algorithm scheduling in 
SRM SRM-41 
address space 
contention for system 
resources SRM-3 
OUCB queues SRM-39, SRM-55 
priorities RM-3 
states SRM-39 
swapping in SRM SRM-45 
address space priorities 
addressing mode 
in SRM SRM-7 
algorithm 
scheduling in SRM _ SRM-4l1l 
swap analysis in SRM SRM-45 
algorithm €SRM) SRM-11 
algorithm request processor SRM-112 
algorithms 
device allocation SRM-3 
effective storage management SRM-4 
I/0 management SRM-4G 
page replacement SRM-3 
processor management SRM-G 
resource-use SRM-4 
algorithms in SRM 
resource use 
introduction 
AMODE 
See addressing mode 
APG management in SRM SRM-50 
ASCB Caddress space control block) 
in SRM 
CPU management SRM-174 
I/Q load balancing user I/Z0 


SRM-3 


SRM-47 


monitoring SRM-150 
individual user 
evaluation SRM-198 


service routine SRM-82 

storage management SRM-134 

user evaluation SRM-130 
swappable user evaluation SRM-194 

ASXB Caddress space extension block) 

in SRM 

I/0 load balancing user I/0 

monitoring SRM-150 
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control block overview 
SRM SRM-59 

control swap-in SRM-116 

control swap-out SRM-118 

CPU affinity mask SRM-160 

CPU load balancing (SRM) SRM-4 

CPU load balancing in SRM SRM-50 

CPU management algorithm in SRM SRM-50 

CPU management in SRM SRM-174 
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DCTI €device connect time 
interval) SRM-150 

debugging hints in SRM SRM-53 
deferred action processor SRM-1]0 
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device allocation SRM-3, SRM-49 
device connect time interval 
See DCTI 
diagnostic techniques in SRM SRM-53 
dispatching SRM-3 
display domain processing SRM SRM-65 
DMDT Cdomain descriptor table) 
function SRM-124 
in resource monitor 
MPL adjustment processing SRM-186 
in storage management SRM-134 
in swap analysis SRM-124 
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ENQ/DEQ algorithm in SRM _ SRM-50 
entry point block 
See RMEP 
entry point summary 
See specific module 
expanded storage SRM-3 
extended storage SRM-3 


F 
fast interface path SRM-78 


finding performance groups SRM-100 
I 
I/O load balancing (SRM) SRM-G 


I/0 management algorithm in SRM SRM-49 
IEAIPSxx, member of SYS1.PARMLIB SRM-3 
IMCB €I/70 management control block) 

in I/0 load balancing user I/0 


monitoring SRM-150 

in I/O management SRM-150 
introduction 

SRM SRM-3 
IRARMCAP 

error processing SRM-124 
IRARMCBS 


diagnostic aids SRM-217 
entry point summary SRM-213 


function SRM-214 

module operation SRM-215 
IRARMCEL 

function SRM-112 
IRARMCEN 

function SRM-110 
IRARMCET 

function SRM-114 
IRARMCHM 

entry point summary SRM-163 
IRARMCPI 

function SRM-126 
IRARMCPM 

entry point summary SRM-173 

function SRM-174% 

module flow SRM-65 
IRARMCPO 

function SRM-128 
IRARMCSI 

error processing SRM-116 

function SRM-116 
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IRARMCSO 
function SRM-118 
IRARMCTL 
entry point summary SRM-107 
function SRM-108 
module flow SRM-65 
processing of 
algorithms/’actions SRM-41 
IRARMCVL 
function SRM-130 
IRARMERR 
entry point summary  SRM-81 
module flow SRM-65 
IRARMEVT SRM-11 
entry point summary SRM-99 
function SRM-100 
module flow SRM-65 
IRARMEV2 SRM-11 
module flow SRM-65 
IRARMFIP 
error processing SRM-79 
function SRM-78 
interface in SRM SRM-5 
module flow SRM-65 
IRARMFPG 
entry point summary SRM-99 
IRARMGLU 
entry point summary SRM-72 
interface in SRM SRM-5 
IRARMHIT 
function SRM-200 
IRARMILO 
function SRM-150 
IRARMIL1 
function SRM-154 
IRARMIL3 
function SRM-156 
IRARMILS5 
function SRM-158 
IRARMIL6 
function SRM-160 
IRARMINT 
entry point summary SRM-72 
error processing SRM-74 
function SRM-74 
interface in SRM SRM-5 
module flow SRM-65 
IRARMIOM 
entry point summary SRM-149 
module flow SRM-65 
IRARMLPI 
function SRM-170 
IRARMMSP 
function SRM-168 
IRARMRMR 
entry point summary SRM-183 
module flow SRM-65 
IRARMRM1 
function SRM-184 
IRARMRM2 
function SRM-186 
IRARMSFT 
function SRM-96 
IRARMSRV 
entry point summary SRM-81 
function SRM-82 
module flow SRM-65 
IRARMSTM 
entry point summary SRM-132 
module flow SRM-65 
IRARMST2 
entry point summary SRM-133 
function SRM-134 
module flow SRM-65 
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IRARMSWP 
entry point summary SRM-123 
module flow SRM-65 
IRARMUPD 
function SRM-164 
IRARMWAR 
entry point summary SRM-207 
module flow SRM-65 
IRARMNLM 
entry point summary SRM-191 
module flow SRM-65 
IRARMWLS 
entry point summary SRM-193 
module flow SRM-65 
IRARMWNM2 
function SRM-194 
IRARMWM3 
function SRM-198 
IRARMWM8 
function SRM-202 
IRARMWR1 
function SRM-208 
IRARMWR3 
function SRM-210 


K 


key 
to logic diagrams 
in SRM SRM-70 
key to logic diagrams SRM-67, SRM-69 


L 


LCCA Clogical configuration 
communication area) 
CPU management SRM-176 
logic diagrams 
See method of operation 
logic for SRM SRM-67 
LPBT Clogical path control block table) 
in SRM SRM-150 


M 


management, storage 
Auxiliary slot shortage 
prevention SRM-47 
Page replacement SRM-47 
Pageable real storage shortage 
prevention SRM-47 
Real page shortage prevention SRM-47 
SQA shortage prevention SRM-47 
Storage load balancing SRM-47 
MCT (storage management control table) 
in resource monitor 
MPL adjustment processing SRM-186 
periodic monitoring SRM-184 
mean-time-to-wait SRM-3 
method of operation 
for SRM SRM-67 
module flow 
SRM SRM-65 


0 


OUCB Cuser control block) 
analysis SRM-55 
important fields SRM-39, SRM-55 
in control swap-in SRM-116 
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in control swap-out SRM-118 
in CPU management SRM-174 

in deferred action SRM-110 

in I/0 load balancing user I/0 
monitoring SRM-150 

in individual user 


evaluation SRM-198 
in select user 
swap-in SRM-126 


swap-out SRM-128 

in storage management SRM-134 
in swap analysis SRM-124 

in swappable user evaluation 
af user evaluation SRM- 130 

in user ready processing SRM-200 

DUXB. Cuser extension block) 

in I/0 load balancing user I/0 
monitoring SRM-150 

in individual user 

evaluation SRM-198 

in storage management SRM-134 
in swappable user evaluation 
in user evaluation SRM-130 
in user ready processing SRM-200 


SRM-194 


SRM-194 


P 


page replacement (SRM) SRM-47 
page replacement in SRM SRM-47 
pageable real storage shortage 
prevention in SRM SRM-47 
pages, active SRM-3 
parameter table 

See RMPT 
performance group descriptor 

See WPGD 
periodic entry point scheduling SRM-114 
priorities, address space -3 
process flow 


SRM mainline SRM-65 


R 


RCT Cresource control table) 
in resource monitor 
MPL adjustment processing SRM-186 
periodic monitoring SRM-184 
Real page shortage prevention 
CSRM) SRM-47 
Auxiliary slot shortage prevention 
CSRM) SRM-47 
real page shortage prevention in 
SRM SRM-47 
report service parameter list 
See RSPL 
residency mode 
in SRM SRM-7 
resource control table 
See RCT 
resource manager control table 
See 
resource monitor 
MPL adjustment processing in 
SRM SRM-186 
Periodic monitoring SRM-184 
resource use algorithms in SRM 
introduction SRM-47 
RMCT CSRM parameter table) 
in algorithm request SRM-112 
in CPU management SRM-174 
in deferred action SRM-110 
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in periodic entry point 
scheduling SRM-114 
in select user 
swap-in SRM-126 
swap-out SRM-128 
in storage management SRM-134 
in swap analysis SRM-124 
in swappable user evaluation SRM-194 
vk transaction reporting SRM-202 
in user ready processing SRM-200 
RMEP CSRM entry point block) 
algorithm and action invocation 
flags SRM-42 
in periodic entry point 
scheduling SRM-114 
RMODE 
See residency mode 
RMPT CSRM parameter table) 
CPU management SRM-176 
RRPA CSRM recovery parameter area) 
in user evaluation SRM-130 
RSPL Creport service parameter list) 
in SRM 
transaction reporting SRM-202 


Ss 


Safety net check SRM-96 
SDWA Csystem diagnostic work area) 
contents SRM-5/7 
SDWAVRA CSDWA variable recording area) 
in SRM SRM-57 
search mask SKM-160 
select user for swap-out 
in SRM SRM-128 
selecting user for swap-in 
selective enablement 
description SRM-149 
modification SRM-149 
monitoring SRM-149 
selective enablement in SRM SRM-49 
serialization SRM-58 
set domain processing in SRM SRM-65 
set key processing in SRM _ SRM-65 
SQA (service queue area) 
shortage prevention SRM-47 
SQA shortage prevention SRM-48& 
SRB (service request block) 
in SRM control SRM-108 
SRM (CSystem Resource Manager) 
method of operation SRM-67 
SRM (system resources manager) 
action/algorithm scheduling SRM-41 
address space states SRM-39 
address space swapping SRM-45 
Adjust domain target MPLs SRM-50 
Adjust extended storage available 
thresholds SRM-50 
Adjust the allocation of double frame 
Pairs SRM-50 
Adjust the system maximum think time 
for logical swapping SRM-50 
Adjust the system MPL SRM-50 
alphabetical list of 
SYSEVENTs SRM-11 
channel measurement monitor stop 


SRM-126 


routine SRM-168 
channel measurement update 
routine SRM-164 


collecting data for RMF SRM-210 
command processing module 

flow SRM-65 

control SRM-108 
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SRM locks SRM-41 
control block overview SRM-59 
control blocks and queues SRM-39 
descriptions SRM-39 
introduction SRM-39 
control function 
introduction SRM-41l 
control swap-in routine SRM-116 
control swap-out routine SRM-118 
CPU management 
algorithm SRM-50 
APG management SRM-50 
ENQ/DEQ@ algorithm SRM-50 
load balancer swap 
analysis SRM-50 
CPU management routines SRM-174 
debugging hints SRM-53 
deferred action processor SRM-110 
diagnostic techniques SRM-53 
entry point summary 
channel measurement SRM-163 
control function SRM-107 
CPU management SRM-173 
functional recovery 
routine SRM-81 
I/0 management SRM-149 
resource monitor SRM-183 
service routine SRM-81 
storage management SRM-132 
swap analysis SRM-123 
SYSEVENT processor SRM-99 
workload activity 
recording SRM-207 
workload manager SRM-193 
error recovery SRM-58 
finding performance groups SRM-100 
functions 
CPU load balancing SRM-4 
I/0 load balancing SRM-4 
MPL target adjustments SRM-4 
storage management SRM-4 
swap analysis SRM-4 
time-slicing SRM-4 
workload management SRM-4 
workload reporting SRM-4 
I/0 load balancing 
user I/0 monitoring SRM-150 
user swap evaluation SRM-156 
I/70 management SRM-49 
device allocation SRM-49 
selective enablement SRM-49 
swap analysis SRM-49 
I/0 management routines SRM-149 
identification of significant I/0 
users SRM-154 
indicators SRM-53 
individual user evaluation SRM-198 
individual user indicators SRM-55 
initialization for RMF SRM-208 
interface 
introduction SRM-5 
interface module 
IRARMFIP SRM-5 
IRARMGLU SRM-5 
IRARMINT SRM-5 
introduction SRM-3 
resource use algorithm SRM-47 
locking considerations for 
SYSEVENTs SRM-5 
major functions SRM-4 
measurement logic path block index 
routine SRM-170 
modification of processor I/0 
enablement SRM-160 
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module/’entry point cross reference 
objectives = 
periodic entry point 
scheduling SRM-114 
processing of algorithms and 
actions SRM-41 
recovery considerations SRM-58 
recovery routine 1 SRM-58 
recovery routine 2 SRM-58 
resource manager control 
table SRM-53 
resource monitor 
MPL adjustment processing SRM-186 
Periodic monitoring SRM-184 
resource use algorithms 
introduction SRM-47 
RMEP algorithm and action invocation 
flags SRM-42 
Safety net check SRM-96 
select user swap-in SRM-126 
select user swap-out SRM-128 
selective enablement 
monitoring SRM-158 
service routine SRM-8&2 
set display domain processing SRM-65 
set domain processing SRM-65 
set key processing SRM-65 
SRM lock SRM-4l1 
storage management 
auxiliary page shortage 
prevention SRM-47 
page replacement SRM-47 
pageable real storage shortage 
prevention SRM-47 
real page shortage 
prevention SRM-47 
SQA shortage prevention SRM-47 
storage load balancing SRM-47 
storage management routines SRM-134 
swap analysis SRM-45, SRM-124 
introduction SRM-45 
swappable user evaluation SRM-194 
SYSEVENT processor 
introduction SRM-11 
SYSEVENTs 
in SRM interface SRM-5 
system (CRMCT) indicators SRM-53, 
SRM-55 


transaction reporting 
algorithm SRM-202 
user COUCB) indicators SRM-55 
user evaluation SRM-130 
user ready processing SRM-200 
workload management functions 
overview SRM-50 
workload manager 
introduction SRM-50 
SRM control table 
See RMCT 
SRM entry point block 
See RMEP 
SRM parameter table 
See RMPT 
SRM tables and entry points SRM-59 
Storage Load Balancing SRM-G48& 
storage load balancing in SRM SRM-47 
storage management (SRM) SRM-4 
storage management algorithm in 
SRM SRM-47 
aeerass management control table 
ee 
swap analysis (CSRM) SRM-4G 
swap analysis in SRM SRM-G5, SRM-49, 
SRM-124 
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swap transition flags SRM-41 
swap-in 
select user for SRM SRM-126 
swap-out 
select user for SRM SRM-128 
swappable user evaluation in 
SRM SRM-194 
swapping SRM-3 
SYSEVENT 
in SRM 
swap analysis SRM-124 
list SRM-11 
locking considerations SRM-5 
processor SRM-11 
processor in storage 
management SRM-134 
SRM interface SRM-5 
SYSEVENTS 
address space SRM-5 
list of SRM-1ll 
SRM service SRM-5 
system status SRM-5 
system diagnostic work area 
See SDWA 
system indicators in SRM SRM-53 
system queue area 
See SQA 
system resources manager 


See S$ 
SYS1.PARMLIB CIEAIPSxx) SRM-3 


T 


tables and entry points in SRM SRM~59 
TCB (task control block) 
in SRM 
I/0 load balancing user I7/0 
monitoring SRM-150 
TCT (Ctiming control table) 
in SRM 


I/0 load balancing user I/0 
monitoring SRM-150 

test pending interrupt (TPI) 

instruction SRM-158 
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time-slice (SRM) SRM-5 
timing control table 
See TCT 
TRQE (transaction reporting queue 
element) 
in SRM transaction reporting SRM-202 


U 


useful fields in SRM SRM-53 
user control table 

See OUCB 
user extension block 

See OUXB 


W 


WAMT (workload activity measurements 
table) 
in SRM 
initialize for RMF SRM-208 
WMST Cworkload manager specifications 
table) 
in SRM 
in transaction reporting SRM-204 
user evaluation SRM-130 
working set SRM-3 
workload activity measurements table 
See WAMT 
workload management (SRM) SRM-5 
workload reporting (SRM) SRM-5 
workload management functions in 
SRM SRM-50 
workload manager (SRM) SRM-G 
workload manager specifications table 
See WMST 
WPGD Cperformance group descriptor) 
in SRM 
individual user 
evaluation SRM-198 
user evaluation SRM-130 
user ready processing SRM-200 
swappable user evaluation SRM-194 
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